List of JAL elements (M-S)
This topic lists and describes the Job Action Language (JAL) elements in this product.
$MEMLIMIT
$MEMLIMIT [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Limit for Number of Usable Virtual Pages Above the Bar This Descriptor represents the limit on the number of usable virtual pages above the bar specified by the MEMLIMIT keyword on the JOB statement in a z/Architecture environment. |
Type | Range Definition Descriptor |
Maximum value | 99999999999999 megabytes |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see SET MEMLIMIT.
MHS ADD
MHS ADD HOLD(identifier | %stringid) NOTES(notes | %stringid) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Add MHS_JAL Hold to a Job This statement allows you to place a job in MHS_JAL hold, optionally including a note. |
Type | Action statement |
Valid values |
|
For more information, see $JXMHS_HOLD, MHS DELETE and MHS REPLACE.
MHS DELETE
MHS DELETE HOLD(identifier | %stringid) | ALL_HOLDS |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Remove MHS_JAL Hold from a Job This statement allows you to remove from the job a previously added or replaced MHS_JAL hold. |
Type | Action statement |
Valid values |
|
For more information, see $JXMHS_HOLD, MHS ADD and MHS REPLACE.
MHS REPLACE
MHS REPLACE HOLD(identifier | %stringid) NOTES(notes | %stringid) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Replace MHS_JAL Hold for a Job This statement allows you to replace a previously added MHS_JAL hold, optionally including a note. |
Type | Action statement |
Valid values |
|
For more information, see $JXMHS_HOLD, MHS ADD and MHS DELETE.
$MHS_USER_HOLD#
$MHS_USER_HOLD# [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Number of /*MHS_USER HOLD JECL Statements This Descriptor represents the number of /*MHS_USER HOLD JECL statements found in the job stream. |
Type | Range Definition Descriptor |
Maximum value | 24 statements |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
MHS_VOL SET EXEMPT
MHS_VOL SET EXEMPT(YES | NO) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Makes Job Ineligible for MHS_VOL Processing This statement allows you to make a job exempt from MHS_VOL processing. |
Type | Action statement |
Valid values |
|
For more information, see $JXMHS_VOL_EXEMPT.
MODELDEF
MODELDEF name (message) CONSOLE_UCM(ucm) [DESC(desc-list)] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Message Definition This statement allows you to define a model message with inserts that allow the message to be used repetitively. You can define a message that combines your text with any Descriptor or Property. |
Type | Definition statement |
Maximum value | Messages exceeding 121 characters are truncated |
Valid values |
[(COL,n,align)],variable | ‘hard-coded-text’,[(COL,n,align)]... The message can consist of a combination of text and Job Descriptors and Properties, in any order. Text is enclosed in apostrophes (‘). To code an apostrophe, two consecutive apostrophes must be used. Each portion of the message is separated from the others by commas.
The considerations for data alignment are:
The basic rules when building a line of text are:
For more information about he facilities provided for formatting messages and displays, refer to Defining-and-using-messages-and-displays.
|
$MSGCLASS_ALTERED
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | SOS ONLY. Test for Altered MSGCLASS This Logic Variable indicates whether the MSGCLASS for the SYSOUT data set was altered by an SOS SET MSGCLASS statement. |
Type | Logic Variable |
Maximum value | Not applicable |
Valid values |
|
Usage
You can use this variable in JAL Logic statements only.
This Variable evaluates to TRUE if the MSGCLASS has been changed by an SOS SET MSGCLASS statement.
For more information, see $CURMSGCLASS, $JXMSGCLASS, and SOS SET MSGCLASS.
$MSGCLASS_OUTCLASS_DUMMY
$MSGCLASS_OUTCLASS_DUMMY(value) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Dummy Associated with MSGCLASS This Descriptor allows you to determine whether the job’s MSGCLASS was specified as a dummy class by JES2 initialization. |
Type | Logic Variable |
Maximum length | 3 characters |
Valid values | value—Is the value that will cause this Descriptor to be set to TRUE, and can be one of the following:
|
Usage
You can use this variable in EVALUATE definition statements and JAL Logic statements, and also as an insert in message definition statements.
In this example, if JES2 initialization has specified that the current MSGCLASS is to be treated as a dummy class, the Property MSGCLASS_DUMMY evaluates to TRUE.
$MSGCLASS_OUTDISP_ABNORM
$MSGCLASS_OUTDISP_ABNORM(disposition) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Abnormal Disposition Associated with MSGCLASS This Descriptor represents the output disposition for abnormal job termination that is associated with the job’s MSGCLASS by JES2 initialization. |
Type | Character string Descriptor |
Maximum length | 5 characters |
Valid values | disposition—Is the disposition that will cause this Descriptor to assume a TRUE value, and can be one of the following:
|
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
- In JLS_LIMITDEF and JLS_CNTLDEF statements
In this example, if JES2 initialization has assigned the current MSGCLASS a disposition of PURGE for jobs that terminate abnormally, the Property MSGCLASS_ABNORM_PURGE evaluates to TRUE.
$MSGCLASS_OUTDISP_NORM
$MSGCLASS_OUTDISP_NORM(disposition) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Normal Disposition Associated with MSGCLASS This Descriptor represents the output disposition for normal job termination that is associated with the job’s MSGCLASS by JES2 initialization. |
Type | Character string Descriptor |
Maximum length | 5 characters |
Valid values | disposition—Is the disposition that will cause this Descriptor to assume a TRUE value, and can be one of the following:
|
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This Descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
- In JLS_LIMITDEF and JLS_CNTLDEF statements
In this example, if JES2 initialization has assigned the current MSGCLASS a disposition of HOLD for jobs that terminate normally, the Property MSGCLASS_NORM_HOLD evaluates to TRUE.
MSGDEF | MSG
MSGDEF name (message) CA7LTERM(terminal) MSGDEF name (message) CONSOLE_NAME(console) [DESC(desc-list)] [LOG] MSGDEF name (message) CONSOLE_UCM(ucmid) [DESC(desc-list)] [LOG] MSGDEF name (message) ROUTCDE(routecde-list) [DESC(desc-list)] [LOG] MSGDEF name (message) USERID(userid | %stringid) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Message Definitions JAL provides a way to communicate with either or both of the operations staff and the job submitter. You can define message text that includes any Descriptor or Property combined with your text. |
Type | Definition statement |
Maximum length | Messages exceeding 121 characters (60 characters for CA7) are truncated. |
Valid values |
[(COL,n,align)],variable | ‘hard-coded-text’,[(COL,n,align)]... The message can consist of a combination of text and Descriptors and Properties, in any order. Text is enclosed in apostrophes (‘). To code an apostrophe, two consecutive apostrophes must be used. Each portion of the message is separated from the others by commas.
The considerations for data alignment are:
The basic rules when building a line of text are:
For more information about the facilities provided for formatting messages and displays, see Defining-and-using-messages-and-displays.
|
For more information, see SEND, WTCA7, WTO, and WTU.
$MSSVOLS
$MSSVOLS [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Volumes Staged By MSS This Descriptor represents the number of virtual volumes that must be staged by the Mass Storage Subsystem (MSS). |
Type | Range Definition Descriptor |
Maximum value | 9999 MSS staged volumes |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
$NJEUSER | $NJEU
$NJEUSER(pattern | %patid | table-id) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | NJE Userid From JES2 Network Job Header This Descriptor represents the userid in the JES2 network job header. |
Type | Character string Descriptor |
Maximum length | 8 characters |
Valid values |
The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned. |
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management .
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This Descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
- In JLS_LIMITDEF and JLS_CNTLDEF statements
$NOTIFY
$NOTIFY(pattern | %patid | table-id) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | NOTIFY Parameter From the JOB statement or /*NOTIFY This Descriptor represents the NOTIFY parameter from the JOB statement or the userid from the /*NOTIFY statement. |
Type | Character string Descriptor. |
Maximum length | 8 characters |
Valid values |
The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned. |
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management .
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This Descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
- In JLS_LIMITDEF and JLS_CNTLDEF statements
ORIF
IF (expression1) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Specify Alternative IF Statement The ORIF statement is used together with a previous IF statement and possibly previous ORIF statement(s), and specifies an expression to be evaluated when the IF and all preceding ORIF statements have a FALSE value. |
Type | Logic statement |
Valid values |
|
For more information, see ELSE, ENDIF, IF, and OTHERWISE.
$ORIGINAL_INSYSID
$ORIGINAL_INSYSID(pattern | %patid | table-id) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Determine the Original System ID if the Job Came from Another Node This Descriptor represents the JES2 system ID where the job was originally read. If the job was submitted at node X and transmitted to node Y, $ORIGINAL_INSYSID would be the system at node X that read the job. |
Type | Character string Descriptor |
Maximum length | 4 characters |
Valid values |
The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned. |
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This Descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
- In JLS_LIMITDEF and JLS_CNTLDEF statements
If job did not come from another node the value of this descriptor will contain the same value as $INSYSID.
For more information, see $INSYSID.
OTHERWISE
IF (expression) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Specify Alternative Action The OTHERWISE statement is part on an IF logical construction. It must follow at least one ORIF statement, and specifies the alternate action(s) taken when the expression evaluated with the IF and any previous ORIF statement resulted in FALSE values. |
Type | Logic statement. |
Valid values |
|
For more information, see ELSE, ENDIF, and IF.
$OUTCLASS
$OUTCLASS(pattern | %patid | table-id) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | JAL Assigned Requeue Class This Descriptor represents a JAL requeue class (the execution class assigned to the job by JAL). |
Type | Character string Descriptor |
Maximum length | 8 character |
Valid values |
The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned. |
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management .
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This Descriptor can also be used as an insert in message definition statements.
For more information, see $XEQCLASS.
$PAGES
$PAGES [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Output Pages This Descriptor represents the estimated number of output pages. |
Type | Range Definition Descriptor |
Maximum value | 99999 expressed in 1000’s of pages. |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $BYTES, $CARDS, and $LINES.
pattern matching function
Descriptor-name(pattern) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | To match a pattern against a string This is a built-in function provided to allow the interrogation of a character Descriptor to see whether its contents match a pattern. |
Type | Pattern Matching Function |
Maximum value | Not applicable |
Valid values |
|
Usage
This function can be used in EVALUATE and JAL Logic statements. It returns a TRUE/FALSE value.
The pattern matching function can be viewed as having a “left” portion and a “right” portion.
- On the left is a Descriptor name, which represents a field containing a character string.
- On the right is a pattern that is matched against the character string contained in the Descriptor named on the left.
Here is an example of how this function works:
PATTERNDEF
PATTERNDEF %patid (source1) [ || (source2)] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | To Construct Patterns Dynamically A pattern definition statement is provided to allow you to create patterns dynamically at JAL execution time. |
Type | Definition statement |
Maximum value | 255 characters |
Valid values | %patid—Is the identification name for the pattern that is created with this statement. The first character must be %, followed by 1 to 23 alphabetic, numeric, national (#, @, $), or underscore (_) characters. The name must be unique. Up to two source fields can used for the construction of the pattern. If you want to construct a pattern from more than two sources then you have to use multiple PATTERNDEF statements, where ‘source’ is a %patid from a previously constructed pattern.
|
Usage
A %patid can be used in any construct that allows pattern matching.
For more information, see PATTERNDEFX.
PATTERNDEFX | PATDEFX
PATTERNDEFX %patid (source) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Extended Pattern Definitions Pattern definition extensions allow you to check for specific types of data in string Descriptors. |
Type | Definition statement |
Maximum value | 255 characters |
Valid values |
|
Usage
A %patid can be used in any construct that allows pattern matching, except for these statements:
- DCS NAG
- DCS REPO
- JOB USER_DISPLAY
For more information, see CHARSET, PATTERNDEF, and STRINGDEF.
With PATTERNDEFX, to use the wildcard characters ‘?’ and ‘*’ you must code them outside a quoted string. Inside a quoted string, the ‘?’ and ‘*’ characters are not interpreted as wildcards.
$PERFORM
$PERFORM(YES | NO) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | JOB Statement PERFORM Keyword This Logic Variable allows you to determine whether the PERFORM= keyword was coded on the JOB statement. This function call returns a TRUE/FALSE value depending on the presence of the PERFORM= keyword on the JOB statement. |
Type | Logic Variable |
Maximum value | Not applicable |
Valid values |
|
Usage
You can use this variable in EVALUATE definition statements and JAL Logic statements, and also as an insert in message definition statements.
For more information, see $JOB_PERFORM, $JXPERFORM, and SET PERFORM.
$PGMR
$PGMR(pattern | %patid | table-id) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Programmer Name From the JOB statement This Descriptor represents the programmer name field from the JOB statement. |
Type | Character string Descriptor |
Maximum length | 20 characters. |
Valid values |
The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned. |
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management .
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This Descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
- In JLS_LIMITDEF and JLS_CNTLDEF statements
PROCEDURE | PROC
PROCEDURE ID(JAL) [DESC(‘user-description’)] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Indicate Type of Action Language This statement is a language directive. Its purpose is to indicate the type of Action Language to be processed. For JAL, it is an optional statement. If present, it must be the first statement in your source input to the Language Processor. The short form for this directive is PROC. |
Type | Language Directive |
Maximum value | Not applicable |
Valid values |
|
$PROCEDURE | $PROC
$PROCEDURE name (proc-list) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Procedure Name/Library This Descriptor lets you determine whether or not a particular procedure name pattern has been coded within the job. |
Type | Unique Descriptor |
Maximum length | Not applicable |
Valid values |
|
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management.
Usage
This Unique Descriptor cannot be used with any other statement and can be used only in the Definition Section of JAL.
$PROGRAM | $PGM
$PROGRAM name (name-list) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Program Name/Library This descriptor lets you determine whether or not a particular program name pattern has been coded on an EXEC statement. The program library reference can also be established. |
Type | Unique Descriptor |
Maximum length | Not applicable |
Valid values |
|
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management.
Usage
This Unique Descriptor cannot be used with any other statement and can be used only in the Definition Section of JAL.
$RACFG | $RG
$RACFG(pattern | %patid | table-id) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | GROUP Parameter From the JOB statement This Descriptor represents the GROUP parameter from the JOB statement. |
Type | Character string Descriptor |
Maximum length | 8 characters |
Valid values |
The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned. |
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management.
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
- In JLS_LIMITDEF and JLS_CNTLDEF statements
For more information, see $RACFU.
$RACFU | $RU
$RACFU(pattern | %patid | table-id) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | USER Parameter From the JOB statement This Descriptor represents the USER parameter from the JOB statement. |
Type | Character string Descriptor |
Maximum length | 8 characters |
Valid values |
The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned. |
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management.
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This Descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
- In JLS_LIMITDEF and JLS_CNTLDEF statements
For more information, see $RACFG.
Range
desc [start,]name,[start1,name1,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Range Definitions This is not a Descriptor. It has been included here for completeness. It describes a “type” of definition statement. When a Descriptor can assume one of a range of values, JAL allows you to divide the range up into segments. You assign Job Property names and specify the starting point for each segment. With this type of definition, multiple Job Properties can be defined with a single statement, but only one can assume a TRUE value. |
Type | Definition statement |
Maximum value | Not applicable |
Valid values |
It is important to remember that starting points and Job Property names are paired. The first Job Property Name is paired with the starting point 0, by default, even if you omit coding the 0. The starting point always is paired with the following Job Property Name, and defines the lower end of the named segment. All values below the starting point belong to the previous segment. This enforces a continuous scale, with no overlaps or gaps. The following rules govern range definition statements:
|
Usage
Use this statement only in the JAL definition section.
The following illustrates the conventions used to assign names to segments of a range:
This statement is interpreted as follows:
$VOL_CART_ALL 0 ?€NO_CART_VOLS < 1 ? FEW_CART_VOLS < 5 ? MANY_CART_VOLS
Where:
- 0—is the optional first starting point. All ranges begin with 0, whether it is specifically coded or omitted.
- NO_CART_VOL—is the Job Property name for the segment “less than 1 cartridge volume” (i.e., no private cartridges requested).
- FEW_CART_VOLS—is the Job Property name for the segment “greater than or equal to 1 cartridge volume but less than 5 cartridge volumes.”
- MANY_CART_VOLS—is the Job Property name for the segment “greater than or equal to 5 cartridge volumes but less than 9999 volumes.”
$RD
$RD(NC | NR | R | RNC) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Checkpoint/Restart Parameter This Logic Variable allows you to check the value of the checkpoint/restart parameter. This parameter is set by the RD keyword on the JOB statement or the SET RD Action statement. |
Type | Logic Variable |
Maximum value | Not applicable |
Valid values |
|
Usage
You can use this variable in EVALUATE definition statements and JAL Logic statements, and also as an insert in message definition statements.
For more information, see SET RD.
$READER_DATE
$READER_DATE |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Reader Date This Display Variable provides the date on which the job was read into the system. |
Type | Display Variable |
Maximum value | 99.365 |
Valid values | $READER_DATE—Is a valid insert in a MSGDEF statement. The date is displayed in the form “yy.ddd”, where “yy” represents the last two digits of the year and “ddd” represents the Julian date. |
Usage
You can use this variable only as an insert in message definition statements.
For more information, see $READER_DAY_OF_MONTH, $READER_DAY_OF_WEEK, $READER_DAY_OF_YEAR, $READER_MONTH, $READER_TIME, $READER_TIME_OF_DAY, and $READER_YEAR.
$READER_DAY_OF_MONTH
$READER_DAY_OF_MONTH [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Reader Day of the Month This Descriptor provides a number representing the day of the month that the job was read into the system. |
Type | Range Definition Descriptor |
Maximum value | 31 |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $READER_DATE, $READER_DAY_OF_WEEK, $READER_DAY_OF_YEAR, $READER_MONTH, $READER_TIME, $READER_TIME_OF_DAY, and $READER_YEAR.
$READER_DAY_OF_WEEK
$READER_DAY_OF_WEEK [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Reader Day of the Week This Descriptor provides a number representing the day of the week that the job was read into the system, with Monday returning a value of 1 and Sunday returning a value of 7. |
Type | Range Definition Descriptor |
Maximum value | 7 |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $READER_DATE, $READER_DAY_OF_MONTH, $READER_DAY_OF_YEAR, $READER_MONTH, $READER_TIME, $READER_TIME_OF_DAY, and $READER_YEAR.
$READER_DAY_OF_YEAR
$READER_DAY_OF_YEAR [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Reader Day of the Year This Descriptor provides a number representing the day of the year that the job was read into the system, counting from January 1 as day 1. This is the ddd portion of the Julian date (yyddd). |
Type | Range Definition Descriptor |
Maximum value | 366 |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $READER_DATE, $READER_DAY_OF_MONTH, $READER_DAY_OF_WEEK, $READER_MONTH, $READER_TIME, $READER_TIME_OF_DAY, and $READER_YEAR.
$READER_MONTH
$READER_MONTH [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Reader Month This Descriptor provides a number representing the month that the job was read into the system, with January returning a value of 1 and December returning a value of 12. |
Type | Range Definition Descriptor |
Maximum value | 12 |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $READER_DATE, $READER_DAY_OF_MONTH, $READER_DAY_OF_WEEK, $READER_DAY_OF_YEAR, $READER_TIME, $READER_TIME_OF_DAY, and $READER_YEAR.
$READER_TIME
$READER_TIME |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Reader Time This display variable provides the time at which the job was read into the system. |
Type | Display Variable |
Maximum value | 23:59:59 |
Valid values | $READER_TIME—Is a valid insert in a MSGDEF statement. |
Usage
You can use this variable only as an insert in message definition statements.
For more information, see $READER_DATE, $READER_DAY_OF_MONTH, $READER_DAY_OF_WEEK, $READER_DAY_OF_YEAR, $READER_MONTH, $READER_TIME_OF_DAY, and $READER_YEAR.
$READER_TIME_OF_DAY
$READER_TIME_OF_DAY [00:00,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Reader Time of Day This descriptor provides the time of day that the job was read into the system, in the format hh:mm, using the 24-hour clock. |
Type | Range Definition Descriptor |
Maximum value | 23:59 |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $READER_DATE, $READER_DAY_OF_MONTH, $READER_DAY_OF_WEEK, $READER_DAY_OF_YEAR, $READER_MONTH, $READER_TIME, and $READER_YEAR.
$READER_YEAR
$READER_YEAR [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Reader Year This descriptor provides a number representing the year the job was read into the system, including the century designation. The format is ccyy, for example 2010. |
Type | Range Definition Descriptor |
Maximum value | 9999 |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $READER_DATE, $READER_DAY_OF_MONTH, $READER_DAY_OF_WEEK, $READER_DAY_OF_YEAR, $READER_MONTH, $READER_TIME, and $READER_TIME_OF_DAY.
$REGION
$REGION [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Maximum Region Size This descriptor represents the maximum region size (in K-bytes) required during execution, as determined by the largest region requested by a job step or the region size specified on the JOB statement. |
Type | Range Definition Descriptor |
Maximum value | 2096128 expressed in K-bytes |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see SET REGION.
$RESTART
$RESTART(NO | YES) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Test for Coded Restart= This Logic Variable indicates that RESTART= is coded on a job card. |
Type | Logic Variable |
Maximum value | Not applicable |
Valid values |
|
Usage
You can use this variable in EVALUATE definition statements and JAL Logic statements, and also as an insert in message definition statements.
If you code RESTART= step1 it will be considered that RESTART= is not coded.
$ROOM
$ROOM(pattern | %patid | table-id) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | JES2 Room Number This descriptor function represents the JES2 room number. |
Type | Character string Descriptor |
Maximum length | 4 characters |
Valid values |
The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned. |
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management.
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This Descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
- In JLS_LIMITDEF and JLS_CNTLDEF statements
$REQUIRES_ZOS
$REQUIRES_ZOS [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Indicate z/OS Release This descriptor represents the z/OS release number. |
Type | Range Definition Descriptor |
Maximum value | 9999 |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
$SAF_ACEE
STRINGDEF %stringid ($SAF_ACEE,length[,start]) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Extract Substring from SAF Accessor Environment Element This descriptor allows you to extract a substring from the SAF Accessor Environment Element. |
Type | Character string Descriptor |
Maximum length | 168 characters |
Valid values |
|
Usage
You can use this descriptor only in STRINGDEF definition statements.
$SAF_ACEEINST
STRINGDEF %stringid ($SAF_ACEEINST,length[,start]) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Extract Substring from Installation Portion of SAF Accessor Environment Element This descriptor allows you to extract a substring from the installation portion of the SAF Accessor Environment Element. |
Type | Character string Descriptor. |
Maximum length | 255 characters |
Valid values |
|
Usage
You can use this descriptor only in STRINGDEF definition statements.
$SAF_CHECK
$SAF_CHECK name [ATTR(ALTER | CONTROL | READ | UPDATE)] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Check Security Authorization ThruPut Manager creates a System Authorization Facility (SAF) compatible secure environment in which to do Job Analysis. This descriptor allows you to check the SAF authorization for the SAF user or group associated with the job. |
Type | Unique Descriptor |
Maximum value | Not applicable |
Valid values |
|
Usage
You can use this descriptor only in the Definition Section of JAL.
$SAF_USERNAME
STRINGDEF %stringid ($SAF_USERNAME,length[,start]) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Extract Substring from SAF User Name This descriptor allows you to extract a substring from the SAF user information. |
Type | Character string Descriptor |
Maximum length | 20 characters |
Valid values |
|
Usage
You can use this descriptor only in STRINGDEF definition statements.
$SCRATCH
$SCRATCH [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Scratch Volumes Requested This descriptor represents the minimum number of requested scratch cartridges and reels. It is the sum of the values contained in $SCRATCH_AUTO, $SCRATCH_MANUAL and $SCRATCH_ REEL. |
Type | Range Definition Descriptor |
Maximum value | 9999 scratch tapes |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $SCRATCH_AUTO, $SCRATCH_CART_ALL, $SCRATCH_MANUAL, $SCRATCH_REEL, and $SCRATCH_VTS.
$SCRATCH_AUTO
$SCRATCH_AUTO [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Automated Scratch Cartridge Volumes This descriptor represents the minimum number of scratch cartridge volumes to be served by the automated system as recorded in the selected Job Profile. |
Type | Range Definition Descriptor |
Maximum value | 9999 scratch cartridges |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $SCRATCH_CART_ALL and $SCRATCH_MANUAL.
It is possible for a given file requesting a scratch volume to go to several volumes. This Job Descriptor assumes only one volume, therefore it represents the minimum number of scratch volumes.
$SCRATCH_CART_ALL
$SCRATCH_CART_ALL [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Scratch Cartridge Volumes Requested This job descriptor represents the minimum number of requested scratch cartridge volumes as recorded in the selected Job Profile. It is the sum of the values contained in $SCRATCH_AUTO and $SCRATCH_MANUAL. |
Type | Range Definition Job Descriptor |
Maximum value | 9999 scratch cartridge volumes |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $SCRATCH_AUTO and $SCRATCH_MANUAL.
$SCRATCH_MANUAL
$SCRATCH_MANUAL [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Manual Scratch Cartridge Volumes This descriptor represents the minimum number of cartridge scratch volumes requested that are to be served manually as recorded in the selected Job Profile. |
Type | Range Definition Descriptor. |
Maximum value | 9999 scratch cartridges |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $SCRATCH_AUTO and $SCRATCH_CART_ALL.
It is possible for a given file requesting a scratch volume to go to several volumes. This Descriptor assumes only one volume, therefore it represents the minimum number of scratch volumes.
$SCRATCH_REEL
$SCRATCH_REEL [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Scratch Non-Cartridge Volumes This descriptor represents the minimum number of non-cartridge scratch tape volumes requested. |
Type | Range Definition Descriptor |
Maximum value | 9999 scratch tape reels |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $SCRATCH, $SCRATCH_AUTO, and $SCRATCH_MANUAL.
It is possible for a given file requesting a scratch volume to go to several volumes. This Descriptor assumes only one volume, therefore it represents the minimum number of scratch volumes.
$SCRATCH_VTS
$SCRATCH_VTS [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Scratch VTS Volumes This descriptor represents the minimum number of VTS scratch volumes requested. |
Type | Range Definition Descriptor |
Maximum value | 9999 scratch VTS volumes |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
SEND
SEND (id1[,id2,...idN]) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Write a Message to a TSO User This JAL statement causes a message to be written to a TSO user. If the user is not logged on, the message is received at the next logon. |
Type | Communication statement |
Valid values | id—Specifies the symbol or list of symbols associated with TSO messages, as established by prior MSGDEF statements. |
For more information, see MSGDEF, WTCA7, WTO, and WTU.
SET
SET ARRIVAL_TIME(nnn) |
For simplification purposes each ‘SET keyword’ has been documented in a separate section and as such it appears that each request requires a separate SET action statement. You can specify several keywords in a single SET statement. This point is illustrated below with several examples.
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Job Attributes The SET statement allows you to set the attributes of the job. Requests made with the SET statement can be reset at any time during the execution of JAL. The value used at EXIT REQUEUE time is the value from the last SET statement executed for a particular type of request. For more information about the actions resulting from a particular keyword, for example LABEL, see SET LABEL. |
Type | Action statement |
SET ARRIVAL_TIME
SET ARRIVAL_TIME(nnn) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Job Arrival Time The SET ARRIVAL_TIME statement allows you to change the job’s arrival time to make it appear that it arrived in its Service Class a specified number of hours earlier. |
Type | Action statement |
Valid values |
|
For more information, see $JXARRIVAL.
The SET ARRIVAL_TIME statement gives you some control over the selection order of jobs in the same Service Class. You can promote a job over jobs that have arrived earlier by setting its arrival time; however, jobs with arrival times that are earlier than the newly set arrival time are still selected first.
SET CATALOG_LOOKUP
SET CATALOG_LOOKUP(NO | YES) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Execution-time Catalog Lookup The SET CATALOG_LOOKUP statement controls whether or not the MHS_VOL function of ThruPut Manager resolves cataloged volume references at execution time. This is useful when you expect catalog changes after Job Analysis but before job execution. |
Type | Action statement |
Valid values |
|
For more information, see $JXCATALOG_LOOKUP.
Setting CATALOG_LOOKUP(YES) adds an extra cycle of catalog lookups for DASD volumes at execution time.
SET CLASS | SET CL
SET CLASS(class | REPROCESS | $ ) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Execution Class The SET CLASS statement assigns the execution class to the job. |
Type | Action statement |
Valid values |
|
For more information, see $JXCLASS.
SET CPUCAP
SET CPUCAP(mmmmmm[:ss] | NO) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Cap Job CPU Allows you to set a limit to the amount of CPU time a job can consume. To the system this parameter has the same effect as if TIME= had been coded in the JOB statement. |
Type | Action statement |
Valid values |
For an explanation of CPU Capping, refer to the System Programming Guide: Base Product. |
For more information, see $CPU, $JOBCPU, $JXCPUCAP, and $STEPCPU.
SET FAIL
SET FAIL |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Job to FAIL at Termination Specifies that the job will be FAILed when JAL processing is completed. |
Type | Action statement |
Valid values | FAIL—Indicates that ThruPut Manager is to queue the job for output (JCL error) instead of execution after JAL processing has completed. |
For more information, see EXIT.
SET JES2_HOLD
SET JES2_HOLD(YES | NO) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Job JES2 Hold Status Specifies whether or not a job is to be held by JES2 at the end of Job Analysis. |
Type | Action statement |
Valid values | JES2_HOLD(YES | NO)—Indicates that the status of the JES2 HOLD action is to be specified. YES | NO— Self-explanatory. |
For more information, see $JXJES2HOLD.
SET LABEL
SET LABEL(character-string | %stringid) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Job Label You can set an identifier which appears in job logs, operator messages, and system message data sets. It allows you to “label” a job or type of job. It also appears in Volume List headings. |
Type | Action statement |
Valid values |
|
For more information, see $JXLABEL.
SET MEMLIMIT
SET MEMLIMIT(value) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set MEMLIMIT Parameter This statement allows you to set the MEMLIMIT parameter for the job that is being analyzed. |
Type | Action statement. |
Valid values |
|
For more information, see $MEMLIMIT.
SET NORMALIZE
SET NORMALIZE(YES | NO) [FACTOR(n)] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Request CPU Normalization This statement allows you to adjust the CPU time for a job to reflect the different speeds of processors. The factors to be applied are CPU dependent and are specified on the TMPARM initialization statement. For further information on the CPU factors, refer to the publication System Programming Guide: Base Product. This feature normally applies to installations with more than one CPU, each with a different processor speed. Note that the factors are applied to the JOB CPU time as well as the step times. For this function to take effect, you must code ‘YES’ and TMPARM must provide factors for the CPU where the job executes. |
Type | Action statement |
Valid values |
|
For more information, see $JXFACTOR and $JXNORM.
SET NOTIFY
SET NOTIFY([nodename.]userid | %stringid) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set NOTIFY Parameter This statement allows you to set the NOTIFY parameter for the job that is being analyzed. |
Type | Action statement |
Valid values |
|
For more information, see $JXNOTIFY and $NOTIFY.
If more than one SET NOTIFY is encountered, the last one executed takes effect.
SET PERFORM
SET PERFORM(nnn | NO) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Performance Group This statement allows you to set the Job Performance Group as if an operator command to reset the performance group has been issued. |
Type | Action statement |
Valid values |
|
For more information, see $JOB_PERFORM, $JXPERFORM, and $PERFORM.
SET PRIORITY
SET PRIORITY(prio | $) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Execution Priority Set the initial execution priority for job. After completion of the Analysis phase the job is requeued with this priority. |
Type | Action statement |
Valid values |
|
For more information, see $JXPRIORITY.
SET RD
SET RD(NC | NR | R | RNC) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Checkpoint/Restart Options Set the checkpoint/restart options for the job. |
Type | Action statement. |
Valid values |
|
For more information, see $RD.
SET REGION
SET REGION(nnnnnnnK | nnnnM [,REAL | VIRT]) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Amount and Type of Storage Required Set the amount and type of central or virtual storage that the job requires. |
Type | Action statement |
Valid values |
|
For more information, see $ADDRSPC and $REGION.
SET SCHENV
SET SCHENV(envname | $NO_SCHENV) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Scheduling Environment Set the scheduling environment for the job. After completion of the Analysis phase, the job is requeued with this scheduling environment. |
Type | Action statement |
Valid values |
|
For more information, see $CURSCHENV and $IN_SCHENV.
SET SERVICE_CLASS
SET SERVICE_CLASS(srvclass) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set WLM Service Class Set the WLM service class for the job. After completion of the Analysis phase, the job is requeued with this WLM service class. |
Type | Action statement |
Valid values | srvclass—A valid WLM service class name, which can be 1-8 alphanumeric, national ($, #, @) characters, or the underscore (_). Underscores (_) must be embedded. |
For more information, see $CURSERVICE_CLASS and $IN_SERVICE_CLASS.
$SETUP
$SETUP(YES | NO) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | JES2 /*SETUP control statement This descriptor allows you to determine if a job was submitted with a JES2 /*SETUP statement. This function call returns a TRUE/FALSE value depending on the presence or absence of a JES2 /*SETUP control statement. This Descriptor is only meaningful if this type of job is to be handled by ThruPut Manager . |
Type | Logic Variable |
Maximum value | Not applicable |
Valid values |
|
Usage
You can use this variable in EVALUATE definition statements and JAL Logic statements, and also as an insert in message definition statements.
SLM SERVICE
SLM SERVICE [GENERAL | PRODUCTION GROUP(name)] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set SLM Service for a Job This statement determines the type of SLM Service that a job is to receive. |
Type | Action Statement |
Valid values |
|
For more information, see $JXSLM_SERVICE.
The last SLM SERVICE statement will be honored.
SLM SET CONTROL_CENTER
SLM SET CONTROL_CENTER(cc-name)TYPE(type-name) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set SLM Control Center and Type This statement specifies the Control Center and Type for a job. |
Type | Action Statement |
Valid values |
|
SLM SET MANAGED
SLM SET MANAGED(YES | NO) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Specify a Job is SLM-managed The SLM SET MANAGED statement is used in a Fast Path implementation approach to specify whether a job is SLM-managed. |
Type | Action Statement |
Valid values |
|
For more information, see $JXSLM_MANAGED.
The job can be removed from SLM-managed status at any time during the execution of JAL. The value used at JAL EXIT time is the value from the last SLM SET MANAGED statement executed.
SLM SET NO_CAPACITY_MANAGEMENT
SLM SET NO_CAPACITY_MANAGEMENT |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Specify a Job is not Subject to Capacity Management Related Constraints The SLM SET NO_CAPACITY_MANAGEMENT statement is used to specify that although a job’s characteristics may make it eligible to be constrained by Capacity Management as specified in the current active SLM Policy, it is not to be subject to those constraints |
Type | Action Statement. |
If the job is not SLM managed, this statement has no effect.
SLM SET NO_OPP
SLM SET NO_OPP |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Specifies that the job is to be exempt from being delayed by OPP and is not subject to online performance protection. |
Type | Action statement |
If the job is not SLM managed, this statement has no effect.
SLM SET QUICKJOB
SLM SET QUICKJOB(YES | NO) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Specify a Job is Quick Job The SLM SET QUICKJOB statement is used to specify a job that executes extremely quick and installation gives it a preferential treatment. |
Type | Action Statement |
Valid values |
|
$SOS_DEFAULT_BURST
$SOS_DEFAULT_BURST(YES | NO) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | BURST Default for the Job This Logic Variable allows you to determine whether the job’s SYSOUT output is to be burst by default. This function call returns a TRUE/FALSE value depending on whether the job’s SYSOUT output is to be burst by default. |
Type | Logic Variable |
Maximum value | Not applicable |
Valid values |
|
Usage
You can use this variable in EVALUATE definition statements and JAL Logic statements, and also as an insert in message definition statements.
For more information, see SOS SET DEFAULT_BURST.
$SOS_DEFAULT_FORMS
$SOS_DEFAULT_FORMS(pattern | %patid | table-id) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | FORMS Default for the Job This descriptor represents the default FORMS setting for the job. |
Type | Character string Descriptor |
Maximum length | 4 characters |
Valid values |
The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned. |
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management.
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This Descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
For more information, see SOS SET DEFAULT_FORMS.
$SOS_DEFAULT_LINECT
$SOS_DEFAULT_LINECT [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | LINECT Default for the Job This descriptor returns the default for the LINECT parameter for the job, specifying the maximum number of lines that JES2 is to print on a page. |
Type | Range Definition Descriptor |
Maximum value | 255 lines |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see SOS SET DEFAULT_LINECT.
$SOS_DEFAULT_PRINT_DEST
$SOS_DEFAULT_PRINT_DEST(pattern | %patid | table-id) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Print Destination Default for the Job This Descriptor represents the default destination for a job’s printed data sets. |
Type | Character string Descriptor |
Maximum length | 127 characters |
Valid values |
The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned. |
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management.
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements.
This Descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
For more information, see SOS SET DEFAULT_PRINT_DEST.
$SOS_DEFAULT_PUNCH_DEST
This Descriptor represents the default destination for a job’s punched data sets.
$SOS_DEFAULT_PUNCH_DEST(pattern | %patid | table-id) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Punch Destination Default for the Job |
Type | Character string Descriptor |
Maximum length | 127 characters |
Valid values |
The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned. |
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management.
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This Descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
For more information, see SOS SET DEFAULT_PUNCH_DEST.
$SOS_JOB_COPIES
$SOS_JOB_COPIES [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Number of Copies of SYSOUT data sets This descriptor returns the number of copies of SYSOUT data sets for the job. |
Type | Range Definition Descriptor |
Maximum value | 255 copies |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see SOS SET JOB_COPIES.
$SOS_JOB_LINES
$SOS_JOB_LINES [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Line Count Limit for the Job This Descriptor returns the limit for the number of lines of SYSOUT output for the job expressed in thousands of lines (a value of 1 represents 1000 lines). |
Type | Range Definition Descriptor |
Maximum value | 999999 thousands of lines |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see SOS SET JOB_LINES.
$SOS_JOB_NOLOG
$SOS_JOB_NOLOG(YES | NO) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | NOLOG Default for the Job This Logic Variable allows you to determine whether the job’s hard-copy log set not to be printed. This function call returns a TRUE/FALSE value depending on whether the job’s hard-copy log set not to be printed. |
Type | Logic Variable |
Maximum value | Not applicable |
Valid values |
|
Usage
You can use this variable in EVALUATE definition statements and JAL Logic statements, and also as an insert in message definition statements.
For more information, see SOS SET JOB_NOLOG.
SOS SET DEFAULT_BURST
SOS SET DEFAULT_BURST(Y | YES | N | NO |) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Default BURST Parameter This statement allows you to set the default for the BURST parameter for a job. This default applies unless the parameter is explicitly set on a JCL or JECL statement. |
Type | Action statement |
Valid values |
|
For more information, see $SOS_DEFAULT_BURST.
SOS SET DEFAULT_FORMS
SOS SET DEFAULT_FORMS(formname | %stringid) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Default FORMS Parameter This statement allows you to set the default for the FORMS parameter for a job. This default applies unless the parameter is explicitly set on a JCL or JECL statement. |
Type | Action statement. |
Valid values |
|
For more information, see $SOS_DEFAULT_FORMS.
SOS SET DEFAULT_LINECT
SOS SET DEFAULT_LINECT(nnn | %stringid) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Default LINECT Parameter This statement allows you to set the defaults for the LINECT parameter for a job. This default applies unless the parameter is explicitly set on a JCL or JECL statement. |
Type | Action statement |
Valid values |
|
For more information, see $SOS_DEFAULT_LINECT.
SOS SET DEFAULT_PRINT_DEST
SOS SET DEFAULT_PRINT_DEST(destination | %stringid) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Default Printer DEST Parameter This statement allows you to set the default for the DEST parameter for a job’s printed data sets. This default applies unless the parameter is explicitly set on a JCL or JECL statement. |
Type | Action statement |
Valid values |
|
For more information, see $SOS_DEFAULT_PRINT_DEST.
SOS SET DEFAULT_PUNCH_DEST
SOS SET DEFAULT_PUNCH_DEST(destination | %stringid) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Default Punch DEST Parameter This statement allows you to set the default for the DEST parameter for a job’s punched data sets. This default applies unless the parameter is explicitly set on a JCL or JECL statement. |
Type | Action statement |
Valid values |
|
For more information, see $SOS_DEFAULT_PUNCH_DEST.
SOS SET DEFAULT_ROOM
SOS SET DEFAULT_ROOM(room | %stringid) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Default ROOM Parameter This statement allows you to set the default for the ROOM parameter for a job. This default applies unless the parameter is explicitly set on a JCL or JECL statement. |
Type | Action statement |
Valid values |
|
For more information, see $ROOM.
SOS SET DO_NOT_LOG_ALTERS
SOS SET DO_NOT_LOG_ALTERS |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Stops Logging SOS ALTER Messages This statement allows you to turn off the logging of statements affected by SOS ALTER actions. |
Type | Action statement |
Valid values | DO_NOT_LOG_ALTERS—Indicates that messages logging the statements affected by SOS ALTER are not to be issued. |
For more information, see SOS SET LOG_ALTERS.
SOS SET JOB_COPIES
SOS SET JOB_COPIES(nnn) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Number of Job Copies This statement allows you to set the number of copies of SYSOUT data sets for the job. This is the same as setting the number of copies using the ACCT keyword of the JOB statement or with the COPIES keyword of the JECL statement /*JOBPARM. |
Type | Action statement |
Valid values |
|
For more information, see $SOS_JOB_COPIES.
SOS SET JOB_LINES
SOS SET JOB_LINES(nnnnnn[, CANCEL | DUMP | WARNING]) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Number of Lines Limit for the Job This statement allows you to set the limit for the number of lines of SYSOUT output for the job, and optionally the action to take if the limit is exceeded. This is the same as setting the number of lines using the LINES keyword of the JOB statement or with the LINES keyword of the JECL statement /*JOBPARM. |
Type | Action statement |
Valid values |
|
For more information, see $SOS_JOB_LINES and $LINES.
SOS SET JOB_NOLOG
SOS SET JOB_NOLOG(Y | YES | N | NO) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set Request for JES2 not to print the job log This statement allows you to set the NOLOG parameter for a job. |
Type | Action statement |
Valid values |
|
For more information, see $SOS_JOB_NOLOG.
SOS SET LOG_ALTERS
SOS SET LOG_ALTERS |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Logging SOS ALTER Messages This statement allows you to log SOS ALTER messages. |
Type | Action statement |
Valid values | LOG_ALTERS—Indicates that messages logging the statements affected by SOS ALTER should be issued. It is a default. If more than one SOS SET LOG_ALTERS or SOS SET DO_NOT_LOG_ALTERS statement is issued, the last one takes effect. |
For more information, see SOS SET DO_NOT_SOS_ALTERS.
SOS SET MSGCLASS
SOS SET MSGCLASS(class) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Set MSGCLASS This statement allows you to specify a MSGCLASS for the job. |
Type | Action statement |
Valid values |
|
For more information, see $CURMSGCLASS, $INMSGCLASS, and $MSGCLASS_ALTERED.
The MSGCLASS can be reset at any time during the execution of the JAL. The value used at JAL EXIT time is the value from the last SOS SET MSGCLASS statement executed.
$SPACE
$SPACE [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Total New DASD Space Requested This Descriptor represents the total amount of new DASD space requested (primary and secondary) for all data sets (temporary and permanent). Note that secondary space represents the maximum amount that the particular job may request (16 extents). |
Type | Range Definition Descriptor |
Maximum value | 99999 expressed in megabytes of DASD space |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $SPACEP, $SPACEPP, $SPACEPS, $SPACET, $SPACETP, and $SPACETS.
The value is rounded upwards by 0.49 of a megabyte. For example, if the maximum width is between zero and half a megabyte it will be treated as if it were zero. If the value was 0.7 then it shows as 1.
$SPACEP
$SPACEP [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Total Permanent DASD Space This Descriptor represents the total amount of new permanent DASD space requested in the job for all data sets. Note that secondary space represents the maximum amount that the particular job may request (16 extents). |
Type | Range Definition Descriptor |
Maximum value | 99999 expressed in megabytes of DASD space |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $SPACEP, $SPACEPP, $SPACEPS, $SPACET, $SPACETP, and $SPACETS.
The value is rounded upwards by 0.49 of a megabyte. For example, if the maximum width is between zero and half a megabyte it will be treated as if it were zero. If the value was 0.7 then it shows as 1.
$SPACEPP
$SPACEPP [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Permanent Primary DASD Space This Descriptor represents the maximum amount of new permanent primary DASD space requested in the job for all data sets. |
Type | Range Definition Descriptor |
Maximum value | 99999 expressed in megabytes of DASD space |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $SPACE, $SPACEP, $SPACEPS, $SPACET, $SPACETP, and $SPACETS.
The value is rounded upwards by 0.49 of a megabyte. For example, if the maximum width is between zero and half a megabyte it will be treated as if it were zero. If the value was 0.7 then it shows as 1.
$SPACEPS
$SPACEPS [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Permanent Secondary DASD Space This descriptor represents the maximum amount (16 extents) of new permanent secondary DASD space requested in the job for all data sets. |
Type | Range Definition Descriptor |
Maximum value | 99999 expressed in megabytes of DASD space |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $SPACE, $SPACEP, $SPACEPP, $SPACET, $SPACETP, and $SPACETS.
The value is rounded upwards by 0.49 of a megabyte. For example, if the maximum width is between zero and half a megabyte it will be treated as if it were zero. If the value was 0.7 then it shows as 1.
$SPACET
$SPACET [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Total Temporary DASD Space This descriptor represents the high water mark of temporary DASD space needed by the job. |
Type | Range Definition Descriptor |
Maximum value | 99999 expressed in megabytes of DASD space |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $SPACE, $SPACEP, $SPACEPP, $SPACEPS, $SPACETP, and $SPACETS.
The value is rounded upwards by 0.49 of a megabyte. For example, if the maximum width is between zero and half a megabyte it will be treated as if it were zero. If the value was 0.7 then it shows as 1.
$SPACETP
$SPACETP [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Temporary Primary DASD Space This Descriptor represents the high water mark of temporary primary DASD space needed by the job. |
Type | Range Definition Descriptor. |
Maximum value | 99999 expressed in megabytes of DASD space |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $SPACE, $SPACEP, $SPACEPP, $SPACEPS, $SPACET, and $SPACETS.
The value is rounded upwards by 0.49 of a megabyte. For example, if the maximum width is between zero and half a megabyte it will be treated as if it were zero. If the value was 0.7 then it shows as 1.
$SPACETS
$SPACETS [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Temporary Secondary DASD Space This descriptor represents the high water mark of temporary secondary DASD space needed by the job. |
Type | Range Definition Descriptor |
Maximum value | 99999 expressed in megabytes of DASD space |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $SPACE, $SPACEP, $SPACEPP, $SPACEPS, $SPACET, and $SPACETP.
The value is rounded upwards by 0.49 of a megabyte. For example, if the maximum width is between zero and half a megabyte it will be treated as if it were zero. If the value was 0.7 then it shows as 1.
$STEPCPU
$STEPCPU [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Maximum Step CPU Time This descriptor represents the maximum estimated CPU time for any step in the job. |
Type | Range Definition Descriptor |
Maximum value | 357912:00 in minutes |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
For more information, see $CPU, $JOBCPU, and SET CPUCAP.
$STEPTOT
$STEPTOT [0,]name1,start2,name2[,...,startN,nameN] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Total Number of Steps This Descriptor represents the total number of steps in a job. |
Type | Range Definition Descriptor |
Maximum value | 255 steps |
Valid values |
|
Usage
You can use this descriptor in the Definition Section of JAL, and also as an insert in message definition statements.
You can use this descriptor to detect single step IEFBR14 jobs so they can be classed accordingly (normally clean up jobs).
STRINGDEF
STRINGDEF %stringid (source1) [ || (source2)] |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | To Define Character Strings Dynamically This definition statement is provided to allow you to dynamically define character strings at JAL execution time. |
Type | Definition statement |
Maximum value | 255 characters |
Valid values |
|
Usage
The STRINGDEF has been provided to allow you to construct character strings from any character Descriptor, or a portion of it. The resulting character string represented by a %stringid can be used in any construct that allows character Job/User descriptors.
$SUBMITTER_RACFG
$SUBMITTER_RACFG(pattern | %patid | table-id) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | RACF Group of Job Submitter This descriptor represents the RACF GROUP parameter of the submitter of the job, which could vary from the RACF GROUP parameter used on the JOB statement. |
Type | Character String Descriptor |
Maximum length | 8 characters |
Valid values |
The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned. |
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management.
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This Descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
- In JLS_LIMITDEF and JLS_CNTLDEF statements
For more information, see $RACFG, $RACFU, and $SUBMITTER_RACFU.
$SUBMITTER_RACFU
$SUBMITTER_RACFU(pattern | %patid | table-id) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | RACF USER Parameter of Job Submitter This descriptor represents the RACF USER parameter of the submitter of the job, which could vary from the RACF USER parameter used on the JOB statement. |
Type | Character String Descriptor |
Maximum length | 8 characters |
Valid values |
The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned. |
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management.
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This Descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
- In JLS_LIMITDEF and JLS_CNTLDEF statements
For more information, see $RACFG, $RACFU, and $SUBMITTER_RACFG.
$SUBMITTER_TSSU
$SUBMITTER_TSSU(pattern | %patid | table-id) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | TSS User ID of Job Submitter This descriptor represents the TSS USER parameter of the submitter of the job, which could vary from the TSS USER parameter used on the JOB statement. |
Type | Character String Descriptor |
Maximum length | 8 characters |
Valid values |
The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned. |
For more information about the description of character string facilities, see Character-string-facilities-tutorial. For more information about the description of table support, see DAL-and-JAL-table-management.
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This descriptor can also be used:
- As an insert in message definition statements
- In a substring function
- In STRINGDEF and PATTERNDEF statements
- In JLS_LIMITDEF and JLS_CNTLDEF statements
For more information, see $TSSUSER.
This descriptor is applicable to TOP SECRET security environments.
substring function
(Character-descriptor[,length[,starting-position]]) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | To extract character substrings This is a built-in function provided to facilitate the creation of character strings from character Descriptors. |
Type | Character String Function |
Maximum value | Not applicable |
Valid values |
|
Usage
The substring function can be used to construct strings with the PATTERNDEF and STRINGDEF definition statements described below.
It can also be used with the JLS_LIMITDEF statement to construct Limiting Agent names.
$SCHENV_SYSAFF
$SCHENV SYSAFF(system-name(s) ) |
This JAL element has the following attributes:
Attribute | Value |
|---|---|
Description | Scheduling Environment System Affinity This descriptor represents the JES2 system affinity associated with the Scheduling Environment. |
Type | Character-string descriptor |
Maximum length | 8 characters |
Valid values | system-name(s)—You can use system-names to determine if the job can execute in the named system. |
Usage
You can use this descriptor in EVALUATE definition statements and JAL Logic statements. This Descriptor can also be used as an insert in message definition statements.