List of JAL elements (M-S)

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• HOLD(identifier)—Indicates that you want to place the job in MHS_JAL hold.
  • identifier—Is 1-8 alphabetic, numeric, or national (@, $ or #) characters, specifying an identifier that can be used to group jobs for easier management.
  • %stringid—Is the name of a dynamically constructed character string that has been defined with a STRINGDEF statement.
• NOTES(notes)—Specifies additional information that can be displayed.
  • notes—A string of 1-200 characters of additional information. If special characters are used, the string must be enclosed in quotes.
  • %stringid—Is the name of a dynamically constructed character string that has been defined with a STRINGDEF statement.

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

• HOLD(identifier | %stringid)—Indicates that you want to remove the MHS_JAL hold.
  • identifier—Is 1-8 alphabetic, numeric, or national (@, $ or #) characters, specifying an identifier that can be used to group jobs for easier management.
  • %stringid—Is the name of a dynamically constructed character string that has been defined with a STRINGDEF statement.
• ALL_HOLDS—Indicates that you want to remove all MHS HOLDs that have been applied to the job.

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

• HOLD(identifier | %stringid)—Indicates that you want to replace the MHS_JAL hold for this job.
  • identifier—Is 1-8 alphabetic, numeric, or national (@, $ or #) characters, specifying an identifier that can be used to group jobs for easier management.
  • %stringid—Is the name of a dynamically constructed character string that has been defined with a STRINGDEF statement.
• NOTES(notes | %stringid)—Specifies additional information that can be displayed.
  • notes—A string of 1-200 characters of additional information. If special characters are used, the string must be enclosed in quotes.
  • %stringid—Is the name of a dynamically constructed character string that has been defined with a STRINGDEF statement.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• EXEMPT(YES | NO)—Indicates that you want to specify whether the job being analyzed is eligible to be placed in the MHS_VOL hold category.
• YES—Indicates that the job being analyzed is to be EXEMPTed from MHS_VOL processing and is, therefore, not eligible to be placed in the MHS_VOL hold category.
• NO—Indicates that the job being analyzed is eligible to be placed in the MHS_VOL hold category. This is the default.

MODELDEF name (message) CONSOLE_UCM(ucm) [DESC(desc-list)]
or
MODELDEF name (message) CONSOLE_NAME(console) [DESC(desc-list)]
or
MODELDEF name (message) ROUTCDE(routecde-list) [DESC(desc-list)]

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

• name—A name used as the message identifier, consisting of 1-24 alphabetic, numeric, national (#, @, $), or underscore characters. The first character cannot be a dollar sign ($) or underscore (_). This operand is positional and required.
• message—The text of the message, using the form:

[(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.

• (COL,n,align)—This is an optional text definition construct that indicates you want column alignment.
• COL—This must be coded as shown.
• n—Specifies the reference column, and can be a value from 1 to 60.
• align—Specifies the desired alignment, and must be one of:
  • L, indicating left alignment.
  • R, indicating right alignment.

The considerations for data alignment are:
For left-aligned data, the column number represents the first column for the first character of data, and subsequent characters are inserted on the left, i. e. in ascending column order.
For right-aligned data, the column number represents the last column for the last character of data, and subsequent characters are inserted on the right, i. e. in descending column order.
If you miscalculate and some of your data is overlaid, it might help you solve your problem if you remember that alignment is performed element by element from left to right.

• variable | ‘hard-coded-text’—A description of the text to be displayed. For variable, this can be any Job Descriptor or Job Property. ‘hard-coded text’ can be any text. After any substitution required for the variable text is resolved, the maximum length must not exceed the limit allowed. This includes the “blanks” that have to be inserted to satisfy the alignment. Data lines longer than the maximum length are truncated.

The basic rules when building a line of text are:

• Separate each element with commas.
• Include text within apostrophes (‘). To code an apostrophe in the text to be displayed, you must use two consecutive apostrophes.
• When formatting text lines, also keep the following in mind:
  •     To separate Job Descriptors and Job Properties from your text, you must insert padding blanks.
  •     Character string Job Descriptors are left-justified, stripped of trailing blanks.
  •     Job Properties and Logic Variables print ‘T’ for TRUE and ‘F’ for FALSE.
  •     For the values displayed for Display Variables (variables with a name starting with $JX) refer to the description for the variable.
  •     EVENT Switches display as ‘ON’ and ‘OFF’.
  •     Numeric Job Descriptors are right-justified, stripped of leading zeros.
  •      For numeric Descriptors, the inserted value is in the units normally used for that Job Descriptor. For example, CPU time is shown in minutes and seconds.
  •     A value in thousands is shown by the character K.
  •     A value in millions is shown by the character M.
• Lines that are longer than the maximum length of 121 characters are truncated.

For more information about he facilities provided for formatting messages and displays, refer to Defining-and-using-messages-and-displays.

• CONSOLE_NAME(console)—Specifies a valid console name to which the message is written. This keyword is mutually exclusive with CONSOLE_UCM and ROUTCDE.
  • console—Is a 2-8 character console name, consisting of alphabetic, national (#, @, $), or numeric characters, the first of which must be alphabetic or national.
• CONSOLE_UCM(ucmid)—Indicates UCMID of the console to which the message is written. This keyword is mutually exclusive with CONSOLE_NAME and ROUTCDE.
  • ucmid—A decimal number between 0-99 inclusive.
• DESC(desc-list)—Indicates the descriptor code of the message.
  • desc-list—A list of the form (d1[,d2,...,d16]), where dn represents a decimal numbers between 1-16 inclusive.
• ROUTCDE(routecde-list)—Indicates the routing code of the message. This keyword is mutually exclusive with CONSOLE_NAME and CONSOLE_UCM.
  • routecde-list—A list of the form (rc1[,rc2,...,rc128]) where rcn represents a decimal number between 1-128 inclusive.

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

• YES—When this subparameter is coded, $MSGCLASS_ALTERED is TRUE if the MSGCLASS was altered by an SOS SET MSGCLASS statement.
• NO—When this subparameter is coded, $MSGCLASS_ALTERED is TRUE if the SYSOUT data set was not altered by an SOS SET MSGCLASS statement.

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:

• N—NO
• Y—YES

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:

• HOLD
• KEEP
• LEAVE
• PURGE
• WRITE

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:

• HOLD
• KEEP
• LEAVE
• PURGE
• WRITE

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

• name—A name used as the message identifier, consisting of 1 to 24 alphabetic, numeric, national (#, @, $), or underscore (_) characters. The first character cannot be a dollar sign ($) or underscore (_). This operand is positional and required. To issue the message defined by this statement, use this name with the Communication statements SEND, WTCA7, WTO, and WTU.
• message—The text of the message, using the form:

[(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.

• (COL,n,align)—This is an optional text definition construct that indicates you want column alignment.
• COL—This must be coded as shown.
• n—Specifies the reference column, and can be a value from 1 to 60.
• align—Specifies the desired alignment, and must be one of the following:
  • L, indicating left alignment.
  • R, indicating right alignment.

The considerations for data alignment are:

• 
  
  • For left-aligned data, the column number represents the first column for the first character of data, and subsequent characters are inserted on the left, i. e. in ascending column order.
  • For right-aligned data, the column number represents the last column for the last character of data, and subsequent characters are inserted on the right, i. e. in descending column order.
  • If you miscalculate and some of your data is overlaid, it might help you solve your problem if you remember that alignment is performed element by element from left to right.
• variable | ‘hard-coded-text’—A description of the text to be displayed. For variable, this can be any Descriptor or Property. ‘hard-coded text’ can be any text. After any substitution required for the variable text is resolved, the maximum length must not exceed the limit allowed. This includes the “blanks” that have to be inserted to satisfy the alignment. Data lines longer than the maximum length are truncated.

The basic rules when building a line of text are:

• Separate each element with commas.
• Include text within apostrophes (‘). To code an apostrophe in the text to be displayed, you must use two consecutive apostrophes.
• When formatting text lines, also keep the following in mind:
  • To separate Descriptors and Properties from your text, you must insert padding blanks.
  • Character string Descriptors are left-justified, stripped of trailing blanks.
  • Properties and Logic Variables print ‘T’ for TRUE and ‘F’ for FALSE.
  • For the values displayed for Display Variables (variables with a name starting with $JX) refer to the description for the variable.
  • Numeric Descriptors are right-justified, stripped of leading zeros.
  • For numeric Descriptors, the inserted value is in the units normally used for that Descriptor. For example, job CPU time is shown in minutes and seconds.
  • A value in thousands is shown by the character K.
  • A value in millions is shown by the character M.
• Lines that are longer than the maximum length are truncated:
  • For messages issued by WTO and WTU, lines longer than 121 characters including the resolved length of any Descriptors are truncated.
  • For messages issued by WTCA7, lines longer than 60 characters including the resolved length of any Descriptors are truncated. If a message issued by WTCA7 contains commas, parentheses are added automatically for you.

For more information about the facilities provided for formatting messages and displays, see Defining-and-using-messages-and-displays.

• CA7LTERM(terminal)—Indicates a CA7 terminal to which a message is written using WTCA7. This keyword is mutually exclusive with CONSOLE_NAME, CONSOLE_UCM, and ROUTCDE.
  • terminal—Is a valid 1 to 8 character CA7 logical terminal name.
• CONSOLE_NAME(console)—Specifies a valid console name to which a message is written using WTO. This keyword is mutually exclusive with CA7LTERM, CONSOLE_UCM, ROUTCDE, and USERID. If the message is written using WTU, this keyword is ignored.
  • console—Is a 2-8 character console name, consisting of alphabetic, national (#, @, $), or numeric characters, the first of which must be alphabetic or national.
• CONSOLE_UCM(ucmid)—Indicates UCMID of the console to which a message is written using WTO. This keyword is mutually exclusive with CA7LTERM, CONSOLE_NAME, ROUTCDE, and USERID. If the message is written using WTU, this keyword is ignored.
  • ucmid—A decimal number between 0-99 inclusive.
• DESC(desc-list)—Indicates the descriptor code of a message written using WTO. If the message is written using WTU, this keyword is ignored.
  • desc-list—A list of the form (d1[,d2,...,d16]), where dn is a decimal number between 1-16 inclusive.
• LOG—This keyword is applicable only to messages issued with a WTU. When LOG is coded, the messages appears in the job log. If LOG is not coded, the default for a WTU is the job’s SYSMSGS file. This keyword is ignored for a WTO.
• ROUTCDE(routecde-list)—Indicates the routing code of a message written using WTO. This keyword is mutually exclusive with CA7LTERM, CONSOLE_NAME, CONSOLE_ UCM, and USERID. If the message is written using WTU, this keyword is ignored.
  • routecde-list—A list of the form (rc1[,rc2,...,rc128]) where rcn is a decimal number between 1-128 inclusive.
• USERID(userid | %stringid)—Specifies a TSO user ID to which the message is to be sent. If the user is not logged on, the message is received at the next logon. This keyword is mutually exclusive with CA7LTERM, CONSOLE_NAME, CONSOLE_ UCM, and ROUTCDE. If the message is not written using SEND, this keyword is ignored.
  • %stringid—You can specify the name of a dynamically constructed character string that has been defined with a STRINGDEF statement.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified as 1-4 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• pattern—This is a hard-coded string. It can be 1-8 alphabetic, numeric, or national (#, @, $) characters, the first of which must be alphabetic or national. It can also include the wildcard characters ‘?’ and ‘*’. If the job was submitted from a virtual machine and forwarded to JES2 through RSCS, this field contains the VM userid.
• %patid—The name of a pattern created with the PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.

The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned.

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

• pattern—This is a hard-coded string. It can be 1-7 alphabetic, numeric, or national (#, @, $) characters, the first of which must be alphabetic or national. It can also include the wildcard characters ‘?’ and ‘*’.
• %patid—The name of a pattern created with the PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.

The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned.

IF (expression1)
  ...
ORIF (expression2)
  true-action
  ...
ENDIF

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

• expression2—A Job Property, Descriptor, or expression combining Job Properties and/or Descriptors. This expression is only evaluated when the IF statement and all prior ORIF statements, if any, have resulted in a FALSE value.
• true-action—The action statements to be executed when the ORIF expression evaluates to TRUE. After completion of the action statements, execution then resumes at the statement that follows the ENDIF.

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

• pattern—This is a hard-coded string. It can be 1-4 alphabetic, numeric, or national (#, @, $) characters. It can also include the wildcard characters ‘?’ and ‘*’.
• %patid—The name of a pattern created with the PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.

The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned.

IF (expression)
  true-action
ORIF (expression)
  true-action
OTHERWISE
  false-action
  ...
ENDIF

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

• expression—A logical expression combining Job Properties and/or Descriptors.
• true-action—Any valid JAL statements which are to be performed should the IF or the ORIF expression evaluate to TRUE.
• false-action—Any valid JAL statements which are to be performed should the IF and ORIF expressions evaluate to FALSE.

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

• pattern—This is a hard-coded string. It can be 1-8 alphabetic or numeric characters. It can also include the wildcard characters ‘?’ and ‘*’.
• %patid—The name of a pattern created with the PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.

The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of pages as 1-5 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• Descriptor-name—A Descriptor that contains character strings.
• pattern—The pattern to be used in the comparison, resulting in either a TRUE (equal) or FALSE (not equal) value returned by the function. Patterns must be constructed according to the rules listed below.

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.

• source1—Represents the first field or value to be used for the construction of the pattern. A pattern can be constructed from one, and only one, of the following sources:
  • A ‘hard-coded character string’ enclosed in quotation marks. For example, PATTERNDEF %CHARS (‘DEV*’)
  • A character Descriptor. For example, PATTERNDEF %FROM_RACFU ($RACFU)
  • The length of the pattern is the length of the Descriptor.
  • The substring function. For example, PATTERNDEF %FROM_USERC1 ($USERC1,5)
    Here, at JAL execution time, the first 5 characters contained in $USERC1 are used. For an explanation of the substring function refer to the “Substring Function” in this reference section.
  • %PATID—A previously defined pattern. You specify the pattern id.
  • %STRINGID—A previously defined character string, created by a STRINGDEF statement. You specify the string id.
  • ||—Indicates that source2 is to be concatenated to source1.
• source2—If present, the same rules as source1.

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

• %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.
• source—Represents value to be used for the construction of the pattern. A pattern can be constructed from any combination of the following sources:
• A quoted string. Characters within a quoted string must match exactly, position for position. For example, PATTERNDEFX %PROD (‘PROD’)
• The wildcard characters (? and *). If ‘*’ is coded, it must be the last character in the pattern. For example, PATTERNDEFX %ALL_PROD (‘PROD’,*)
• A Property defined by a prior STRINGDEF statement. Characters within the string must match exactly, position for position. For example, for a string that must begin with the first three characters of the RACF userid followed by the string ‘TEST’:
  STRINGDEF  %RACF_1_2_3  ($RACFU,3)
  PATTERNDEFX %TEST_NAME    (%RACF_1_2_3,’TEST’)
• One of the special definition characters:
  • @ Matches a single alphabetic character.
  • A Matches a single alphabetic or national (#, @, $) character.
  • # Matches a single numeric character.
  • N Matches a single numeric or national (#, @, $) character.
    For example, to test for job names that must begin with ‘PROD’ followed by three numbers and a letter:
    PATTERNDEFX %PROD_JOB (‘PROD’,###@)
• One or more character sets defined with the CHARSET statement. The position being compared must match one of the characters in the set. To test for a four digit odd number, for example:
  CHARSET     %ODD          (‘13579’)
  PATTERNDEFX %TEST_ODD_NUM (###,%ODD)

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

• YES—When TRUE, it indicates that the keyword PERFORM= was coded on the JOB statement.
• NO—When TRUE, it indicates that the keyword PERFORM= was not coded on the JOB statement.

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

• pattern—This is a hard-coded string. It can be 1-20 alphabetic, numeric, or national (#, @, $) characters. It can also include the period (.) and the wildcard characters ‘?’ and ‘*’. If pattern contains a blank, or any characters other than those previously listed, it must be enclosed in apostrophes.
• %patid—The name of a pattern created with the PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.

The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned.

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

• ID(JAL)—Indicates that you are identifying the type of Action Language to be processed.
• JAL—Specifies that the language is JAL. If the statement is not coded, JAL is the default.
• DESC(‘user-description’)—Allows you to specify a description that is included in the output from DISPLAY and REFRESH commands for identification purposes.
• ‘user-description’—Is a string of up to 24 characters, enclosed in apostrophes. To include an apostrophe, code two successive apostrophes.

$PROCEDURE name (proc-list)
[LIB(dsname-pattern | % patid | table)] |
[TYPE (INSTREAM |PRIVATE | SYSTEM]

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

• name—Specifies the procedure name to be associated with this $PROCEDURE Descriptor. This symbol must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore(_) characters. The first character must be alphabetic or national. The name must be unique and cannot start with the character $.
• proc-list—A pattern list for a procedure name. The list can have 1 or many elements (up to 20) and it can be either a hard-coded pattern, a %patid representing a pattern created with a PATTERNDEF, a $TABLEn construct, or a combination of these types. The procedure list is an “OR” list. That is, any one of the procedures satisfies the condition.
• LIB(dsname-pattern | %patid | table-id)—The data set name from which the procedures procname was retrieved.
• dsname-pattern—A hard-coded data set name pattern.
• %patid—The name of a pattern created with a PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.
• TYPE—TYPE defines where the procedure was found. It is one of the following:
  • INSTREAM—The procedure was found in an input stream procedure.
  • PRIVATE—The procedure was found in a private library
  • SYSTEMS—The procedure was found in a system library.

$PROGRAM name (name-list)
             [EXEC_ACCT(pattern | %patid | table-id | $BLANK) |
              EXEC_ACCTFLD(field#,pattern | %patid | table-id | $BLANK)]
             [LINKLIST | LIB(dsname-pattern | % patid | table-id)]
             [ONLY]
             [PARM(pattern | %patid | table-id | $BLANK) |
              PARMFLD(field#,pattern | %patid | table-d | $BLANK)|
              PARMDD]
             [STEPNAME(pattern | %patid | table-id)]

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

• name—Specifies the Job Property name to be associated with this $PROGRAM Descriptor. This symbol must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore(_) characters. The first character must be alphabetic or national. The name must be unique and cannot start with the character $.
• name-list—A pattern list for a program name. The list can have 1 or many elements (up to 20) and it can be either a hard-coded pattern, a %patid representing a pattern created with a PATTERNDEF, a $TABLEn construct, or a combination of these types. The program list is an “OR” list. That is, any one of the programs satisfies the condition.
• EXEC_ACCT(pattern | %patid | table-id)—When coded, indicates that you want to match the character pattern against the entire ACCT string found on the EXEC statement of a matching program name. The Job Property returns a TRUE value only if both match. This keyword is mutually exclusive with EXEC_ACCTFLD.
  • pattern—A hard-coded pattern of 1-8 characters.
  • %patid—The name of a pattern created with a PATTERNDEF statement.
  • table-id—Identifies a specific table and indicates which subtable is to be searched.
  • $BLANK—Is a special subparameter that allows you to check for blanks.
• EXEC_ACCTFLD(field#,pattern | %patid | table-id)—When coded, indicates that you want to match the character pattern against a specific field    of the ACCT string found on the EXEC statement of a matching program name. The Job Property returns a TRUE value only if both match. This keyword is mutually exclusive with EXEC_ACCTFLD.
  • field#—Indicates the field reference number of the accounting related field and must be specified as decimal digit(s) 1-68.
  • pattern—A hard-coded pattern of 1-8 characters.
  • %patid—The name of a pattern created with a PATTERNDEF statement.
  • table-id—Identifies a specific table and indicates which subtable is to be searched.
  • $BLANK—Is a special subparameter that allows you to check for blanks.
• LIB(dsname-pattern | %patid | table-id)—When coded, the LIB parameter requests that the presence of either a STEPLIB or JOBLIB be determined. If there is both a JOBLIB and a STEPLIB, the STEPLIB takes precedence. The Job Property assumes a TRUE value only if there is a JOBLIB or STEPLIB and the first data set name matches the pattern. This keyword is mutually exclusive with the LINKLIST keyword.
  • dsname-pattern—A hard-coded data set name pattern.
  • %patid—The name of a pattern created with a PATTERNDEF statement.
  • table-id—Identifies a specific table and indicates which subtable is to be searched.
• LINKLIST—If this keyword is present, the presence of a JOBLIB or STEPLIB DD statement in the job stream causes the Job Property to be set to FALSE. This keyword is mutually exclusive with the LIB keyword.
• ONLY—If this keyword is present, the Job Property is set to TRUE when the specified program name is the only program name referenced in the job. There could be multiple references.
• STEPNAME(pattern | %patid | table-id)—When coded indicates that you want to match the stepname of the statement that is calling a program that satisfies the program list. The Job Property returns a TRUE value only if both match.
  • pattern—A hard-coded pattern of 1-8 characters.
  • %patid—The name of a pattern created with a PATTERNDEF statement.
  • table-id—Identifies a specific table and indicates which subtable is to be searched.
• PARM(pattern | %patid | table-id | $BLANK)—When coded, indicates that you want to match the character pattern against the entire parameter string found on the EXEC statement of a matching program name. The Job Property returns a TRUE value only if both match. This keyword is mutually exclusive with PARMFLD.
  • pattern—This is a hard-coded string. It can be 1-100 alphabetic, numeric, or national characters. It can also include the wildcard characters ‘?’ and ‘*’. If pattern contains a blank, or any characters other than those previously listed, it must be enclosed in apostrophes.
  • %patid—The name of a pattern created with a PATTERNDEF statement.
  • table-id—Identifies a specific table and indicates which subtable is to be searched.
  • $BLANK—Is a special subparameter that allows you to check for blanks.
• PARMFLD(field#,pattern | %patid | table-id | $BLANK)—When coded, indicates that you want to match the pattern against a specific field in the parameter string found on the EXEC statement of a matching program name. The Job Property returns a TRUE value only if both match. This keyword is mutually exclusive with PARM.
  • field#—A number 1-50 indicating the particular field for pattern matching. Fields within a parameter character string are separated by commas.
  • pattern—This is a hard-coded string. It can be 1-100 alphabetic, numeric, or national characters.   It can also include the wildcard characters ‘?’ and ‘*’. If pattern contains a blank, or any characters other than those previously listed, it must be enclosed in apostrophes.
  • %patid—The name of a pattern created with a PATTERNDEF statement.
  • table-id—Identifies a specific table and indicates which subtable is to be searched.
  • $BLANK—Is a special subparameter that allows you to check for blanks.
• PARMDD—Is a keyword that specifies a DD statement that contains the PARM data. This DD is read and the data is automatically passed to the calling program. The maximum amount of data is 32760 bytes. PARMDD is mutually exclusive with the PARM and PARMFLD keywords.

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

• pattern—This is a hard-coded string. It can be 1-8 alphabetic, numeric, or national (#, @, $) characters, the first of which must be alphabetic or national. It can also include the wildcard characters ‘?’ and ‘*’.
• %patid—The name of a pattern created with the PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.

The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned.

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

• pattern—This is a hard-coded string. It can be 1-8 alphabetic, numeric, or national (#, @, $) characters, the first of which must be alphabetic or national. It can also include the wildcard characters ‘?’ and ‘*’.
• %patid—The name of a pattern created with the PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.

The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned.

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

• desc—The Job or User Descriptor.
• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Syntax for specifying the starting point and the permissible range of values depends on the specific Descriptor. See the detailed descriptions.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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:

• Each starting point in a range definition must be higher than any preceding starting point.
• JAL always assumes that a range begins at 0 and ends with the highest legal value for that Descriptor.
• The upper limit for a specific Descriptor is shown in this reference section.
• There is no practical limit to the number of segments that you can define.
• While it is not a syntax error to code a range definition that consists of simply one segment name, this defines a segment that covers all values from 0 to the upper limit for that Descriptor. The defined Job Property must therefore always be TRUE.

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

• NC—Returns a value of TRUE when the RD parameter is set to NC.
• NR—Returns a value of TRUE when the RD parameter is set to NR.
• R—Returns a value of TRUE when the RD parameter is set to R.
• RNC—Returns a value of TRUE when the RD parameter is set to RNC.

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.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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.

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

• start—The starting point of a segment. The first starting point must be 00:00, but can be omitted if desired. Starting points are specified in hours and minutes on a 24-hour clock, with 00:00 representing midnight.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in k-bytes of memory as 1-7 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• NO—RESTART= was not coded on a job card.
• YES—RESTART= was coded on a job card.

Description

JES2 Room Number

This descriptor function represents the JES2 room number.

Type

Character string Descriptor

Maximum length

4 characters

Valid values

• pattern—This is a hard-coded string. It can be 1-4 alphabetic, numeric, or national (#, @, $) characters, the first of which must be alphabetic or national. It can also include the hyphen (-) and the wildcard characters ‘?’ and ‘*’.
• %patid—The name of a pattern created with the PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.

The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned.

Description

Indicate z/OS Release

This descriptor represents the z/OS release number.

Type

Range Definition Descriptor

Maximum value

9999

Valid values

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in k-bytes of memory as 1-7 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• %stringid—Is the identification name for the character string that is extracted. The first character must be % followed by 1 to 23 alphabetic, numeric, national (#, @, $), or underscore (_) characters. The name must be unique.
• length—Is the number of characters to be extracted, from the range 1-168.
• start—Is the starting position within the SAF Accessor Environment Element at which extraction is to begin. If this parameter is omitted, the default is 1 (the first character).

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

• %stringid—Is the identification name for the character string that is extracted. The first character must be % followed by 1 to 23 alphabetic, numeric, national (#, @, $), or underscore (_) characters. The name must be unique.
• length—Is the number of characters to be extracted, from the range 1-255.
• start—Is the starting position within the installation portion of the SAF Accessor Environment Element at which extraction is to begin. If this parameter is omitted, the default is 1 (the first character).

$SAF_CHECK name [ATTR(ALTER | CONTROL | READ | UPDATE)]
               CLASS(‘class’ | %stringid)
               RESOURCE(‘resource’ | %stringid)

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

• name—Specifies a unique name that consists of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. The first character must be alphabetic or national. Note that the first character of the name cannot be a dollar sign ($) or underscore (_). This is not equivalent to a Property Name, in that Property Names are assigned TRUE/FALSE values. This name can be used only in EVAL statements, and is assigned one of the following values:
  • AUTHORIZED
  • DENIED
  • NOT_DEFINED
  • ERROR
  • JALTEST
• ATTR(ALTER | CONTROL | READ | UPDATE)—Indicates that you want to check the access authority.
  • ALTER—Checks whether the SAF user or group has total control over the resource.
  • CONTROL—Checks whether the SAF user or group has CONTROL authority for the resource.
  • READ—Checks whether the SAF user or group can open the resource only to read. This is the default.
  • UPDATE—Checks whether the SAF user or group can open the resource to read or write.
• CLASS(‘class’ | %stringid)—Specifies that SAF authorization checking is to be performed for a resource of the specified class.
  • ‘class’—Is a 1-8 byte SAF resource class, enclosed in apostrophes.
  • %stringid—You can specify the name of a dynamically constructed character string that has been defined with a STRINGDEF statement. The length can be up to 8 characters.
• RESOURCE(‘resource’ | %stringid)—Specifies that SAF authorization checking is to be performed for the specified resource.
  • ‘resource’—Is a 1-255 byte SAF resource entity, enclosed in apostrophes.
  • %stringid—You can specify the name of a dynamically constructed character string that has been defined with a STRINGDEF statement. The length can be up to 255 characters.

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

• %stringid—Is the identification name for the character string that is extracted. The first character must be % followed by 1 to 23 alphabetic, numeric, national (#, @, $), or underscore (_) characters. The name must be unique.
• length—Is the number of characters to be extracted, from the range 1-20.
• start—Is the starting position within the SAF user name at which extraction is to begin. If this parameter is omitted, the default is 1 (the first character).

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of volumes as 1-4 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of volumes as 1-4 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of volumes as 1-4 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of volumes as 1-4 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of volumes as 1-4 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of volumes as 1-4 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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.

SET ARRIVAL_TIME(nnn)
   CATALOG_LOOKUP(NO | YES)
   CLASS(class | REPROCESS | $)
   CPUCAP(mmmm[:nn] | NO)
   FAIL
   JES2_HOLD(YES | NO)
   LABEL(name | %stringid)
   NORMALIZE(YES | NO) [FACTOR(n)]
   NOTIFY(nodename.userid | %stringid)
   PERFORM(nnn | NO)
   PRIORITY(prio | $)
   RD(NC | NR | R | RNC)
   REGION(nnnK | nnnM [, VIRT | REAL])
   SCHENV(envname)
   SERVICE_CLASS(srvclass)

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

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

• ARRIVAL_TIME(nnn)—Requests that the arrival time for the job be set back a specified number of hours. The short form for this keyword is ARRIVAL.
• nnn—A number in the range 1-255, representing the number of hours that the arrival time should be set back.

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

• CATALOG_LOOKUP(NO | YES)—Indicates whether catalog lookups are to be performed at execution time.
• NO—The MHS_VOL function uses the list of DASD volumes created at Job Analysis. This is the default.
• YES—When the job is about to be selected for execution, the MHS_VOL function does catalog lookups to refresh the list of DASD volumes.

Description

Set Execution Class

The SET CLASS statement assigns the execution class to the job.

Type

Action statement

Valid values

• CLASS(class | REPROCESS | $)—Sets an execution class for this job. The short form for this keyword is CL.
• class—Any character A-Z or 0-9.
• REPROCESS—Indicates that the job is to be placed in the Job Analysis Class to be reprocessed later. This implies that the job will be placed in JES2 HOLD.
• $—This indicates to ThruPut Manager  to set the class equal to the Job Submission Class.

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

• CPUCAP(mmmmmm[:ss] | NO)—Requests that the CPU time for job be capped. The CPU cap is specified in minutes and seconds:
  • mmmmmm—Specifies the maximum number of CPU minutes. The value can range from 0 to 357912.
  • ss—Specifies the number of seconds. The value can range from 0 to 59.
    mmmmmm can be specified without seconds but ss must be preceded by mmmmmm. For example, 0:30 = 30 sec.
• NO—This parameter indicates that CPUCAP is not to be used. Allows you to override a previous SET CPUCAP statement.

For an explanation of CPU Capping, refer to the System Programming Guide: Base Product.

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.

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.

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

• LABEL(character-string | %stringid)—Indicates a job label is to be set.
• character-string—A string of 1-20 characters. If special characters are used, the string must be enclosed in apostrophes. An apostrophe can be included by coding two consecutive apostrophes.
• %stringid—The name of a character string created with a STRINGDEF statement.

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

• LABEL(value)—Requests that the MEMLIMIT parameter be set.
• value—Specifies a value to be used as the limit on the total size of usable virtual storage above the bar in a single address space. The value may be expressed in megabytes (M), gigabytes (G), terabytes (T), or petabytes (P). nnnnn may be a value from 0 to 99999, with a maximum value of 16384P. It can be one of the following:
  • nnnnnM
  • nnnnnG
  • nnnnnT
  • nnnnnP
• NOLIMIT—Specifies that there is no limit on the virtual storage to be used above the bar.

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

• NORMALIZE(YES | NO)—Requests that the CPU times be normalized for this job. The short form for this keyword is NORM.
• YES | NO—Self-explanatory.
• FACTOR(n)—Indicates which set of normalization factors in TMPARM should be used. This keyword is valid only if NORMALIZE(YES) has been specified.
• n—Is an integer from the range 1-8, used as an index into the set of normalization factors specified by TMPARM. The default factor set is 1.

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

• NOTIFY([nodename.]userid] | %stringid)—Requests that the NOTIFY parameter be set.
• [nodename.]userid—Identifies a node and a TSO userid at that node. The nodename is the symbolic name defined by your installation, and is 1 to 8 alphanumeric or national ($, #, @) characters. The first character of nodename must be alphabetic or national ($, #, @). The userid must be defined at the node. It is 1 to 7 alphanumeric or national ($, #, @) characters, and the first character must be alphabetic or national ($, #, @). This subparameter follows the conventions used in JCL, therefore you can specify a userid alone, a nodename and userid, or simply a nodename.
• %stringid—The name of a character string created with a STRINGDEF statement. The string must evaluate to one of:
  • A valid TSO userid, optionally including a nodename.
  • Blanks, allowing the NOTIFY parameter to be removed.

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

• PERFORM—Requests that the performance group be set.
• nnn—1 to 999 as normally specified in the MVS RESET command.
• NO—Reverts to whatever the job had. This allows you to “reset” the value in a situation where you have previously set it in JAL.

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

• PRIORITY(prio | $)—Indicates that the execution priority is to be set. The short form for this keyword is PR.
• prio—The desired priority, which can be expressed in one of two ways:
  • PRIORITY(n), where n is a number in the range 0-15. This is the usual way of expressing this parameter.
  • PRIORITY(n1,n2), where n1 and n2 are both numbers in the range 0-15. This method complements the priority aging technique used by JES2. It allows you to set the initial priority as if the job had already “aged”. n2 represents the amount of initial “aging” in units of 1/16th.
• $—Coding this character indicates to ThruPut Manager  that you want the job submission priority.

Description

Set Checkpoint/Restart Options

Set the checkpoint/restart options for the job.

Type

Action statement.

Valid values

• RD(NC | NR | R | RNC)—Requests that checkpoint/restart options are to be set.
• NC—Suppresses automatic and deferred checkpoint restarts.
• NR—Suppresses automatic checkpoint restart but permits deferred checkpoint restarts.
• R—Restart, checkpoints allowed. Indicates that the operator can perform automatic step restart if the job fails, and does not suppress checkpoint restarts.
• RNC—Restart, no checkpoints. Indicates that the operator can perform automatic step restart if the job fails, but suppresses automatic and deferred checkpoint restarts.

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

• REGION(nnnnnnnK | nnnnM [,VIRT | REAL])—Indicates that you want to specify the amount of central or virtual storage that the job requires.
  • nnnnnnnK—1-7 digits specifying the required storage in kilobytes, up to a value of 2096128. If this value is not a multiple of 4, the system rounds it up to the next highest multiple of 4.
  • nnnnM—1-4 digits specifying the required storage in megabytes, up to a value of 2047.
  • REAL—Requests central (real) storage.
  • VIRT—Requests virtual storage.

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

• envname—A valid scheduling environment name, which can be 1-16 alphanumeric, national ($, #, @) characters, or the underscore (_). Underscores (_) must be embedded.
• $NO_SCHENV—A reserved word that indicates that a SCHENV keyword coded on the JOB statement is to be ignored.

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.

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

• YES—Returns a TRUE value if there is a /*SETUP statement in the job.
• NO—Returns a TRUE value if there is no /*SETUP statement in the job.

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

• GENERAL— Requests that the job be given GENERAL Service.
• PRODUCTION GROUP(name)—Requests that Non-Scheduled Production job to be placed to PRODUCTION queue.
• GROUP(name)—A group that is specified within the SLM dialog.

Description

Set SLM Control Center and Type

This statement specifies the Control Center and Type for a job.

Type

Action Statement

Valid values

• CONTROL_CENTER(cc-name)—Is a Control Center name, which represents the first part of Service Group name. It is 1-8 characters long and consists of alphanumeric and national ($, #, @) characters. The first character cannot be numeric.
• TYPE(type-name)—Is a Type name, which represents the second part of Service Group name. It is 1-8 characters long and consists of alphanumeric and national ($, #, @) characters. The first character cannot be numeric.

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

• YES—Specifies that SLM is to manage the job.
• NO—Specifies that SLM is not to manage the job.

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.

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

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

• YES—The job will be treated by SLM as QUICKJOB.
• NO—The job will be treated normally.

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

• YES—When TRUE, it indicates that the job’s SYSOUT output is to be burst.
• NO—When TRUE, it indicates that the job’s SYSOUT output is not to be burst.

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

• pattern—Is a 1-8 character pattern to be matched against the default FORMS setting for the job.
• %patid—The name of a pattern created with the PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.

The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• pattern—Is a 1-127 character pattern to be matched against the default destination setting for the job’s printed data sets.
• %patid—The name of a pattern created with the PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.

The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned.

Description

Punch Destination Default for the Job

Type

Character string Descriptor

Maximum length

127 characters

Valid values

• pattern—Is a 1-127 character pattern to be matched against the default destination setting for the job’s punched data sets.
• %patid—The name of a pattern created with the PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.

The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• YES—When TRUE, it indicates that the job log is set not to be printed.
• NO—When TRUE, it indicates that the job log is set to be printed.

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

• YES—It indicates that the job’s SYSOUT output is to be burst.
• NO—It indicates that the job’s SYSOUT output is not to be burst.

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

• formname—Identifies the print or punch forms, and is 1 to 8 alphanumeric or national ($, #, @) characters.
• %stringid—The name of a character string created with a STRINGDEF statement.

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

• nnn—Maximum number of lines JES2 is to print on each page, and is a number from 0-255.
• %stringid—The name of a character string created with a STRINGDEF statement.

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

• destination—Represents the destination for the printed data sets, and must conform to the definition for a legal destination in JCL or JECL.
• %stringid—The name of a character string created with a STRINGDEF statement.

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

• destination—Represents the destination for the punched data sets, and must conform to the definition for a legal destination in JCL or JECL.
• %stringid—The name of a character string created with a STRINGDEF statement.

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

• room—Represents the programmer’s room number, and is 1-4 alphanumeric characters.
• %stringid—The name of a character string created with a STRINGDEF statement.

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.

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

• JOB_COPIES(nnn)—Indicates that you want to set the number of copies of printed output for the job.
• nnn—Is a number in the range 1-255.

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

• JOB_LINES(nnnnnn[, CANCEL | DUMP | WARNING])—Indicates that you want to set the limit for the number of lines of printed output for the job.
• nnnnnn—Is a number in the range 0-999999, representing the number of thousands of lines (a value of 1 represents 1000 lines).
• CANCEL—Requests that the job be canceled without a storage dump when the output for the job exceeds the limit.
• DUMP—Requests that the job be canceled with a storage dump when the output for the job exceeds the limit.
• WARNING—Requests that the job be allowed to continue when the output for the job exceeds the limit, but that the JES2 warning message be issued to the operator.

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

• YES—Requests that JES2 not print the job log.
• NO—Requests that JES2 print the job log.

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.

Description

Set MSGCLASS

This statement allows you to specify a MSGCLASS for the job.

Type

Action statement

Valid values

• MSGCLASS(class)—Indicates that the MSGCLASS for the job is to be set.
• class—Any character A-Z or 0-9.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of megabytes as 1-5 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of megabytes as 1-5 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of megabytes as 1-5 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of megabytes as 1-5 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of megabytes as 1-5 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of megabytes as 1-5 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of megabytes as 1-5 decimal digits.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified as mmmmmm:ss, where, mmmmmm ranges from 0 to 357912 in minutes and ss ranges from 0 to 59 in seconds. The value mmmmmm can be specified without seconds but ss must be preceded by mmmmmm. For example, 30 seconds is specified as 0:30.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• start—The starting point of a segment. The first starting point must be 0, but can be omitted if desired. Starting points are specified in number of steps from 0 to 255.
• name—The Property Name assigned to a segment of the range. Each Property Name must be unique and can consist of 1 through 24 alphabetic, numeric, national (#,@,$), or underscore (_) characters. Note that the first character of each name cannot be a dollar sign ($) or underscore (_). You can code the single character dollar sign ($) in place of a Property Name for ranges you wish to ignore.

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

• %stringid—Is the identification name for the character string 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. You can use up to two fields for the construction of the character string.
• source1—Represents the first field or value to be used for the construction of the character string. It can be one, and only one, of the following sources:
  • A ‘hard-coded character string’. For example, STRINGDEF %STRING (‘DEVELOP’)
  • A character Descriptor. For example, STRINGDEF %FROM_RACFU ($RACFU)
    The length of the character string is the length of the Descriptor.
  • An installation system symbol. Any string that begins with an ampersand (&) is treated as a system symbol. If the symbol is not defined at the time of Job Analysis, the resulting value is blank. System symbols are accepted only in a STRINGDEF.
  • The substring function. For example, STRINGDEF %NAME1 ($USERC1,5)
    Here, at JAL execution time, the first 5 characters contained in $USERC1 are used. For an explanation of the substring function refer to the “Substring Function” in this section.
  • %PATID—A previously defined pattern. You specify the pattern id. The pattern is converted to a character string. That is, any wildcard characters are treated as normal characters.
  • %STRINGID—A character string that was previously defined with STRINGDEF. You specify the string id.
  • ||—Indicates that source2 is to be concatenated to source1.
• source2—Represents the second field or value to be used in the construction of the character string. source2 is optional and if present its value is concatenated to the value from source1. The rules are the same as source1.

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

• pattern—This is a hard-coded string. It can be 1-8 alphabetic, numeric, or national (#, @, $) characters, the first of which must be alphabetic or national. It can also include the wildcard characters ‘?’ and ‘*’.
• %patid—The name of a pattern created with the PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.

The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned.

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

• pattern—This is a hard-coded string. It can be 1-8 alphabetic, numeric, or national (#, @, $) characters, the first of which must be alphabetic or national. It can also include the wildcard characters ‘?’ and ‘*’.
• %patid—The name of a pattern created with the PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.

The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned.

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

• pattern—This is a hard-coded string. It can be 1-8 alphabetic, numeric, or national (#, @, $) characters, the first of which must be alphabetic or national. It can also include the wildcard characters ‘?’ and ‘*’.
• %patid—The name of a pattern created with the PATTERNDEF statement.
• table-id—Identifies a specific table and indicates which subtable is to be searched.

The pattern, %patid, or table entries are matched against the Descriptor. If a match occurs, a TRUE value is returned.

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

• character descriptor—Represents a character Job/User Descriptor.
• length—The number of characters to be used. If this operand is omitted the length of the Job/User descriptor is used. The substring function allows a value from 1 to 255.
• starting position—The starting position of the character string within the Job/User Descriptor. If this operand is omitted the default value is 1.

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.