Input Parameters

Input parameters for the function routine are:

SSOB
SSIB
SSRR

SSOB Contents: The caller of the function code sets the following fields in the SSOB control block on input:

Field Name: Description
SSOBID: Identifier 'SSOB'
SSOBLEN: Length of the SSOB (SSOBHSIZ) control block
SSOBFUNC: SSI function code 20 (SSOBRQST)
SSOBSSIB: Address of an SSIB control block
SSOBINDV: Address of the function dependent area (SSRR control block)

Set all other fields in the SSOB control block to binary zeros before issuing the IEFSSREQ macro.

SSIB Contents: The caller of the function code sets the following fields in the SSIB control block on input:

Field Name: Description
SSIBID: Identifier 'SSIB'
SSIBLEN: Length of the SSIB (SSIBSIZE) control block
SSIBSSNM: Subsystem name — name of the subsystem to which this Request Job ID call is directed.
It is usually the primary JES, or in the case of JES2, a possible secondary JES.

Set all other fields in the SSIB control block to binary zeros before issuing the IEFSSREQ macro.

SSRR Contents: The caller of the function code sets the following fields in the SSRR control block on input:

Field Name

Description

SSRRLEN

Length of the SSRR (SSRRSIZE) control block

SSRRFLG1

Flag byte

The caller of this function code can set one or more of the following bits:

SSRRUASC
If SSRRUASC is set, JES assigns the JES-provided job name to the job found in the ASCB control block as follows:
1. Started task from the ASCBJBNS field, if the job is running as a started task, MOUNT, or LOGON.
2. Batch job from the ASCBJBNI field, if the job is running as a batch job or APPC transaction program.
SSRRJNMP
If SSRRJNMP is set, JES uses the user-provided jobname in the SSRRJNM field.

Note: The caller can set either the SSRRUASC bit or the SSRRJNMP bit, but not both.
SSRRJOBL
If SSRRJOBL is set, JES explicitly creates a joblog.
SSRRNJBL
If SSRRNJBL is set, JES does not explicitly create a joblog.

Note: JES explicitly creates a joblog by default when neither the SSRRJOBL bit nor the SSRRNJBL bit is set. Note that the caller cannot set both the SSRRJOBL bit and the SSRRNJBL bit.

SSRRVER

Version of mapping for the caller. Set this field to SSRRCVER (an IBM-defined integer constant within the SSRR control block).

SSRRSECB

For JES2 only, contains the pointer to a caller-supplied ECB. When JES2 posts this ECB, JES2 is ending. In response, issue the Return Job ID call (SSI function code 21). Normal $PJES2 processing will hang if the application does not issue this call. JES2 will also issue message HASP715 when the proper Return Job ID call is not made in a timely manner to alert the operator of a Return Job ID call being needed.

Note: Do not rely on this ECB always being posted during the ending of JES2. JES2 can also end abnormally.

SSRRJNM

An optional job name to be used for this job. The name is left-justified and padded to the right with blank (X'40') characters. JES uses this name as the job name if the caller set the SSRRJNMP bit in the SSRRFLG1 flag byte, as described earlier.

Set all other fields in the SSRR control block to binary zeros before issuing the IEFSSREQ macro.