Special job variables are items of system information which the user can read like job variables. Special job variables can be addressed via the dummy user ID SYSJV. No genuine user ID $SYSJV may therefore exist in the system.
There is no catalog entry for special job variables. The path name structure cannot therefore be used. A catalog ID must not be specified.
The names of special job variables are displayed in the form “$SYSJV.<jvname>”.
In the command SHOW-JV-ATTRIBUTES, the entry “JV-NAME=$SYSJV.<jvname>” can also contain wildcards. Specifying “$SYSJV.” causes the names of all special job variables available in the system to be output.
With INFORMATION=*ALL-ATTRIBUTES, the format of special job variables is desribed in an additional output line. The description appears in the currently set task language: English or German (this can be set task-specifically with the command /MODIFY-MSG-ATTRIBUTES; see the “Commands” manual [1]).
Special job variables can only be read. Their use is possible only in the following
commands:
MODIFY-JV in the SET-VALUE operand (value transfer)
MODIFY-JV-CONDITIONALLY in the SET-VALUE operand (value transfer)
SHOW-JV in the JV-CONTENTS operand (value output)
SKIP-COMMANDS in the CONDITION operand (in conditional expressions)
Special job variables can also be used in inputing command sections from job variables (see section “Input from job variables”).
Access to a special job variable is only possible if the desired item of information also exists in the system. For example, no program name can be output if the interrogating job has not loaded a program ($SYSJV.PROGNAME). In this case the user receives message JVS04B2 indicating that the desired special job variable is “empty” (if zero characters is possible in the following output format). The following two tables list all special job variables. The first table is sorted alphabetically and the second table (starting on "Special job variables ") is sorted by category. The second table does not contain descriptions of the special job variables.
Special job variables sorted alphabetically
Name | Output format | Contents |
$SYSJV.ACCOUNT | 1-8 characters | Account number of the running task |
$SYSJV.COUNTER | 4 characters, 0001-9999 | Task specific counter 1 |
$SYSJV.DATE | yy-mm-ddiii | Current date (ISO format) and the day (iii) in the current year |
$SYSJV.DATE4 | yyyy-mm-ddiii | Current date (ISO4 format) and the day (iii) in the current year |
$SYSJV.DATE-ISO4 | yyyy-mm-dd | Current date (ISO4 format) |
$SYSJV.DATE-TIME-LONG | yyyy-mm-dd hh:mm:ss | Current date and time (format for text output) |
$SYSJV.DATE-TIME-SHORT | yyyy-mm-dd.hhmmss | Current date and time (format for file names) |
$SYSJV.DATUM | dd.mm.yyyy | Current date (German format) |
$SYSJV.DAY | MON, TUE, WED, THU, | Current day of the week, English |
$SYSJV.HOME-CATID | 1-4 characters | Catalog ID of the home pubset |
$SYSJV.HOST | 1-8 characters | BCAM name of the local host, e.g. D046ZE08 |
$SYSJV.JOB-CLASS | 1-8 characters | Job class of the current task |
$SYSJV.JOB-ELAPSED-TIME | -dddddddddd-hh:mm:ss | Time passed since the start of the job (see $SYSJV.JOB-LOGON), where “d” is the number of days; |
$SYSJV.JOB-LOGON | yyyymmdd.hhmm | Time of the start of the job, e.g. 20010112.0901 |
$SYSJV.JOB-LOGON-ISO | yyyy-mm-dd hh:mm | Job start time (ISO format), e.g. 2000-01-12 09:01 |
$SYSJV.JOB-MONJV | 0-54 characters | Name of the job monitoring job variable MONJV |
$SYSJV.JOBNAME | 0-8 characters | Job name of the running task |
$SYSJV.JOB-SOURCE | 1-54 characters | Path of the original source file (ENTER- or procedure file, also displayed in the field ORIGFILE in /SHOW-JOB-STATUS) |
$SYSJV.JOB-SPOOLIN | yyyymmdd.hhmm | Time of the job spoolin, e.g. 20012212.0901 |
$SYSJV.JOB-SPOOLIN-ISO | yyyy-mm-dd hh:mm | Time of the job spoolin (ISO format), e.g. 2000-01-12 09:01 |
$SYSJV.MONAT | JAN, FEB, MRZ, APR, MAI, JUN, JUL, AUG, SEP, OKT, NOV, DEZ | Current month, German |
$SYSJV.MONTH | JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC | Current month, English |
$SYSJV.PERS-ID | 0-8 characters | Personal ID for personal logons |
$SYSJV.PRINCIPAL | 1-256 characters | Principal name of the Kerberos identification in the dialog logon |
$SYSJV.PRIO | 1-3 digits | Priority of the running task |
$SYSJV.PROCESSOR | 0-8 characters | Processor name of the TIAM station; e.g. D046KR11 |
$SYSJV.PROCESSOR-APPL | 0-8 characters | Processor name of the TIAM station in an application (e.g. OMNIS); e.g. D016ZE04 |
$SYSJV.PROC-LEVEL | 1-3 characters | Procedure level |
$SYSJV.PROC-SOURCE | 1-54 characters | Path name of the copy of the source file (copied ENTER or procedure file, also shown in the field CMDFILE of /SHOW-JOB-STATUS) |
$SYSJV.PROG-MONJV | 0-54 characters | Name of the program-monitoring MONJV |
$SYSJV.PROGNAME | 0-41 characters | Name of the loaded program if this was loaded from an LMS library or as a * file |
$SYSJV.REMAINING-BS2000-RUNTIME | 5 characters: UNDEF, UNLIM or hh:mm | Remaining runtime which is available to the BS2000 system to shut down before the real or virtual machine is stopped; supported on SQ servers; on other BS2000 servers the value is always UNDEF. |
$SYSJV.SNO | 3 characters | System session number |
$SYSJV.STARTUPTYPE | 1 characters | Startup type, e.g. Z, F, C, W, S |
$SYSJV.STATION | 0-8 characters | Station name of the TIAM station; e.g. DSB11243 |
$SYSJV.STATION-APPL | 0-8 characters | Station name of the TIAM station in an application (e.g. OMNIS); e.g. BT200175 |
$SYSJV.STATIONTYPE | 0-8 characters | Device type of the TIAM station, e.g. 9750 DDT |
$SYSJV.STD-CATID | 1-4 characters | Standard user catalog identifier (default pubset) |
$SYSJV.SYSCMD | 1-54 characters | Name of the assigned file or logical system file in parentheses |
$SYSJV.SYSDTA | 1-54 characters | Name of the assigned file or logical system file in parentheses |
$SYSJV.SYSID | 1-3 characters | System identifier 2 |
$SYSJV.SYSLST | 1-54 characters | Name of the assigned file or logical system file in parentheses |
$SYSJV.SYSOUT | 1-54 characters | Name of the assigned file or logical system file in parentheses |
$SYSJV.SYSTEM-VERSION | 10 characters | System version number e.g. V17.0A00pp with pp=PVLU |
$SYSJV.TAG | MO, DI, MI, DO, FR, SA, SO | Current day of the week, German |
$SYSJV.TASK-CPU-USED | ssssss.ssss | Current CPU time for the task since LOGON |
$SYSJV.TASK-CPU-USED-LONG | ssssssssss.ssss | Current CPU time for the task since LOGON for so-called "long-running transactions" |
$SYSJV.TASK-MODE | 2-6 characters: | Mode of the running task |
$SYSJV.TEMP-PREFIX | 1 character | Prefix for temporary job variables and files, e.g. # |
$SYSJV.TIME | hh:mm:ss | Current time |
$SYSJV.TIME-ZONE | +hh:mm i | Time difference between the local time zone and GMT, where the indicator “i” shows the current time:
|
$SYSJV.TIMESTAMP | yyyy-mm-ddhhmmss | Time stamp with date and time (UTC) in the same format as in a MONJV |
$SYSJV.TOMORROW | yyyy-mm-dd | Tomorrows date |
$SYSJV.TSN | 4 characters | TSN of the running Task |
$SYSJV.USERID | 1-8 characters | User ID of the running Task |
$SYSJV.VIRTUAL-HOST | 0-8 characters | BCAM name of the virtual host (a value is only returned for TIAM V13.0 and higher) |
$SYSJV.YESTERDAY | yyyy-mm-dd | Yesterdays date |
$SYSJV.ZEIT | hh-mm-ss | Current time |
1Initialized to zero and incremented by one prior to each read access within a task; it thus contains values which are unique only within a task, e.g. for label generation.
2A code assigned to a home pubset.
Special job variables sorted by category
Category | Name | Output format |
Date/time | $SYSJV.DATE | yy-mm-ddiii |
$SYSJV.DATE4 | yyyy-mm-ddiii | |
$SYSJV.DATE-ISO4 | yyyy-mm-dd | |
$SYSJV.DATE-TIME-LONG | yyyy-mm-dd hh:mm:ss | |
$SYSJV.DATE-TIME-SHORT | yyyy-mm-dd.hhmmss | |
$SYSJV.DATUM | dd.mm.yyyy | |
$SYSJV.DAY | MON, TUE, WED, THU, FRI, SAT, SUN | |
$SYSJV.MONAT | JAN, FEB, MRZ, APR, MAI, JUN, JUL, AUG, SEP, OKT, NOV, DEZ | |
$SYSJV.MONTH | JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC | |
$SYSJV.TAG | MO, DI, MI, DO, FR, SA, SO | |
$SYSJV.TIME | hh:mm:ss | |
$SYSJV.TIME-ZONE | +hh:mm i | |
$SYSJV.TIMESTAMP | yyyy-mm-ddhhmmss | |
$SYSJV.TOMORROW | yyyy-mm-dd | |
$SYSJV.YESTERDAY | yyyy-mm-dd | |
$SYSJV.ZEIT | hh-mm-ss | |
Job information | $SYSJV.ACCOUNT | 1-8 characters |
$SYSJV.COUNTER | 4 characters, 0001-9999 | |
$SYSJV.JOB-CLASS | 1-8 characters | |
$SYSJV.JOB-ELAPSED-TIME | 20 characters | |
$SYSJV.JOB-LOGON | 13 characters | |
$SYSJV.JOB-LOGON-ISO | 16 characters | |
$SYSJV.JOBNAME | 0-8 characters | |
$SYSJV.JOB-SOURCE | 1-54 characters | |
$SYSJV.JOB-SPOOLIN | 13 characters | |
$SYSJV.JOB-SPOOLIN-ISO | 16 characters | |
$SYSJV.PERS-ID | 0-8 characters | |
Job information (cont.) | $SYSJV.PRINCIPAL | 1-256 characters |
$SYSJV.PRIO | 1-3 digits | |
$SYSJV.PROC-SOURCE | 1-54 characters | |
$SYSJV.PROGNAME | 0-41 characters | |
$SYSJV.STD-CATID | 1-4 characters | |
$SYSJV.TASK-CPU-USED | 11 characters, ssssss.ssss | |
$SYSJV.TASK-CPU-USED-LONG | 15 characters, ssssssssss.ssss | |
$SYSJV.TASK-MODE | 2-6 characters: | |
$SYSJV.TSN | 4 characters | |
$SYSJV.USERID | 1-8 characters | |
Information on job variables | $SYSJV.JOB-MONJV | 0-54 characters |
$SYSJV.PROG-MONJV | 0-54 characters | |
$SYSJV.TEMP-PREFIX | 1 characters | |
System files and procedures | $SYSJV.PROC-LEVEL | 1-3 characters |
$SYSJV.SYSCMD | 1-54 characters | |
$SYSJV.SYSDTA | 1-54 characters | |
$SYSJV.SYSLST | 1-54 characters | |
$SYSJV.SYSOUT | 1-54 characters | |
TIAM-Information | $SYSJV.HOST | 1-8 characters |
$SYSJV.PROCESSOR | 0-8 characters | |
$SYSJV.PROCESSOR-APPL | 0-8 characters | |
$SYSJV.STATION | 0-8 characters | |
$SYSJV.STATION-APPL | 0-8 characters | |
$SYSJV.STATIONTYPE | 0-8 characters | |
$SYSJV.VIRTUAL-HOST | 0-8 characters | |
System data | $SYSJV.HOME-CATID | 1-4 characters |
$SYSJV.REMAINING-BS2000-RUNTIME | 5 characters: UNDEF, UNLIM or hh:mm | |
$SYSJV.SNO | 3 characters | |
$SYSJV.STARTUPTYPE | 1 characters | |
$SYSJV.SYSID | 1-3 characters | |
$SYSJV.SYSTEM-VERSION | 10 characters |