DTMODE - Create DSECT or data list for TMODE macro

General

Application area:	Requesting and accessing lists and tables; see "Requesting and accessing lists and tables"
Macro type:	Definition macro; see "Types of macro"

Macro description

The DTMODE macro generates a description of the input/output area for the TMODE macro in 31-bit addressing mode. The description is created in the form of a DSECT or a data list and starts with the standard header. The initialization values for the standard header are entered in the data list.

Macro format and description of operands

DTMODE

DSECT=YES / NO

[,PREFIX=p]

DSECT=
Specifies whether a DSECT for the output area is to be generated or a data list.

YES
A DSECT is generated.

NO
A data list is created.

PREFIX=
Specifies a character string to be prefixed to the symbolic names of the DSECT/data list.

p
Prefix for the symbolic names. Length <= 2 characters.
Default setting: p = TM.

Layout of the DSECT for the I/O area

           DTMODE DSECT=YES
1          #INTF REFTYPE=REQUEST,INTNAME=TMODE,INTCOMP=002
1 *---------------- P A R A M E T E R L I S T
1 TMODPL    DSECT
1           FHDR  UNIT=43,FUNCT=1,VERS=1
2          DS    0A
2          DS    0XL8                GENERAL OPERAND LIST HEADER
2          DC    AL2(43)             FUNCTION UNIT NUMBER
2          DC    AL1(1)              FUNCTION NUMBER
2          DC    AL1(1)              FUNCTION INTERFACE VERSION NUMBER
2          DC    X'FFFFFFFF'          Returncode is virgin
1 TMODTSN   DC    CL4' '                  TASK SEQUENCE NUMBER
1 TMODUSER  DC    CL8' '                  USER IDENTIFICATION NUMBER
1 TMODACCT  DC    CL8' '                  TASK ACCOUNT NUMBER
1 TMODTIME  DC    F'0'                    TASK CPU TIME
1 TMODPRIV  DC    AL1(0)                  TASK PRIVELEDGE CODE
1 TMODPRSA  EQU   1                       SYSTEM ADMINISTRATOR BIT
1 TMODPRUS  EQU   2                       USER BIT
1 TMODLLEN  DC    AL1(0)                  PHYSICAL LINE LENGTH (TERMINAL)
1 TMODVDT   DC    AL1(0)                  VIRTUAL DEVICE TYPE
1 TMODLINC  EQU   1                       LINE MODE CAPABILITY
1 TMODFORC  EQU   2                       FORMAT MODE CAPABILITY
1 TMODCMPC  EQU   4                       COMPATIBLE MODE CAPABILITY
1 TMODFYSC  EQU   8                       PHYSICAL MODE CAPABILITY
1 TMODEXLC  EQU   16                      EXTENDED LINE MODE CAPABILITY
1 TMODEOM   EQU   64                      EVANESCENT OUTPUT MESSAGES(VDU)
1 TMODTYPE  DC    AL1(0)                  TASK OR TERMINAL TYPE
1 TMODPRI   DC    AL1(0)                  TASK PRIORITY
1 TMODMSG   DC    X'00'                   MSG OPTIONS              :*
1 TMODMSGF  EQU   X'01'                     |
1 TMODMSGC  EQU   X'02'                     |
1 TMODMSGH  EQU   X'04'                     > SEE /OPTION COMMAND
1 TMODMSGT  EQU   X'08'                     |
1 TMODMSGL  EQU   X'20'                     |
1 TMODBUFS  DC    H'0'                    BUFFERSIZE
1 TMODPNAM  DC    CL8' '                  PROGRAM NAME
1 TMODNAME  DC    CL8' '                  JOB NAME FROM /LOGON
1 TMODPLL   EQU   *-TMODPL                 LENGTH OF PARAMETERLIST

Explanation of field contents

TMODTSN:	task sequence or job number (TSN); 4 characters
TMODUSER:	user ID; 8 characters
TMODACCT:	account number; 8 characters
TMODTIME:	CPU time consumed by the task, multiple of 100 microseconds; 8-digit decimal number. Values > 204800 sec are not output; this maximum value is repeated for subsequent calls
TMODPRIV: TMODLLEN:	privilege status assigned to the task, where X'01' corresponds to task runs under the system administration ID (TSOS) X'02' corresponds to task runs under the (nonprivileged) caller's user ID (physical) line length at the data display terminal; only when line mode is used
TMODVDT:	characteristics of the data display terminal
TMODTYPE:	type of data display terminal; X'00' if the job is a batch job, otherwise: X'02' corresponds to 8103 Printer Terminal X'04' corresponds to 8150 Data Display Terminal X'11' corresponds to TRANSDATA 8415, 8418 X'15' corresponds to 8151 Data Display Terminal X'16' corresponds to 8152 Data Display Terminal X'17' corresponds to 8110 Printer Terminal X'18' corresponds to 8161 Data Display Terminal with 54 characters per line X'19' corresponds to 8161 Data Display Terminal with 64 characters per line X'1A' corresponds to 8161 Data Display Terminal with 80 characters per line X'2C' corresponds to 8162 Data Display Terminal X'2D' corresponds to 8160 Data Display Terminal X'35' corresponds to 9750 Data Display Terminal X'4F' corresponds to 9763 Data Display Terminal
TMODPRI:	run priority of the task; 2-digit hexadecimal number
TMODBUFS:	length of the physical I/O buffer of the terminal; 4-digit hexadecimal number. Not with batch jobs.
TMODPNAM	program name, if module was loaded using the static loader (ELDE); 8 characters. X'00...0', if module was loaded using the dynamic binder loader (DBL).
TMODNAME:	job name from the SET-LOGON-PARAMETERS command.