z/OS MVS Using the Subsystem Interface
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Output Parameters

z/OS MVS Using the Subsystem Interface
SA38-0679-00

Output parameters for the function routine are:
  • SSOBRETN
  • SSJIRETN
  • IAZJBCLD (Job Class Information service)
SSOBRETN Contents: When control returns to the caller and register 15 contains a zero, the job information services function places one of the following decimal values in the SSOBRETN field:
Value (Decimal)
Meaning
SSJIOK (0)
Request successful.
SSJIERVR (4)
Request completed with possible errors, see SSJIRETN for reason code.
SSJIERRU (8)
Request cannot be completed because of user error, see SSJIRETN for reason code.
SSJIERRJ (12)
Request cannot be completed, SSJIRETN contains internal reason code.
SSJIPARM (16)
The parameter list, ie, the SSJI extension is an invalid format - it is not an SSJI, the service version number is not supported, or the SSJI is not large enough.
SSJIRETN Contents: In addition to the return code in SSOBRETN, the field SSJIRETN contains the service related error or more specific information about the error. SSJIRETN will be set to one of the following decimal values when SSOBRETN is not zero:
Value (Decimal)
Meaning
SSJIUNSF (4)
Unsupported subfunction requested
SSJINTDS (24)
SSJIUSER does not point to the correct data area
SSJIUNSD (28)
SSJIUSER control block version number is not correct
SSJISMDS (32)
SSJIUSER control block length is too small
Return codes in SSJIRETN specific to the Job Class Information service: The following return codes are set if the Job Class Information service was requested and SSOBRETN is zero:
Value (Decimal)
Meaning
SSJIOK (0)
Success

Job Class Information service, IAZJBCLD contents: For the Job Class Information service (function code SSJIFJCO), two types of data, fixed data in the IAZJBCLD and elements for each job class that match the filters specified. The following describes the fixed data fields returned in the IAZJBCLD:

Field Name
Description
JBCLVERO
Subsystem version number (currently 4)
JBCLSMCL
STC message class
JBCLTMCL
TSU message class
JBCLDPTR
Pointer to first job class data buffer
JBCLNJC
Number of job classes returned

Job Class Information Elements: Each element contains a header and two sections, class attribute table and member specific attributes. The class attribute table and member specific sections contain a prefix and data section.

Job Class Information Element header (mapped by JBCLDHDR DSECT):
Field Name
Description
JBCTEYE
Eyecatcher 'DCAT'
JBCTOHDR
Offset to first section
JBCTNEXT
Address of next CAT
JBCLDHSZ
Size of header
Class Attribute Table Prefix section (mapped by JBCTPREF DSECT):
Field Name
Description
JBCTHDLN
Length of entire job class entry (maximum value is 65535)
JBCTHDTP
Type of this section
JBCTHDMD
Modifier
JBCTHDSZ
Size of prefix section
Class Attribute Table Data section (mapped by JBCLDCAT DSECT):
Field Name
Description
JBCTLEN
Length of job class data section
JBCTTYPE
Type of this section (JBCLTCAT)
JBCTMOD
Modifier
JBCJOBFL
Job flags
JBCBATCH
Batch job
JBCTSUJB
Time sharing user
JBCTCJB
System task
JBCVALJB
Valid job types
JBCNOJNL
No journal option
JBCNOUPT
No output option
JBCTSCAN
TYPRUN=SCAN was specified
JBCTCOPY
TYPRUN=COPY was specified
JBCRSTRT
Allow warm start to re-que for execution
JBCJBOPT
Job options flag
JBCTHOLD
TYPRUN=HOLD
JBCNOLOG
No job log option
JBCXBMII
XBM II job
JBCQHELD
Class queue is held
JBCPROCN
Procedure library number
JBCSMFLG
SMF Flag
JBCNOUSO
Do not take IEFUSO exit
JBCNOTY6
Do not produce Type 6 SMF record
JBCNOUJP
Do not take IEFUJP exit
JBCNOT26
Do not produce Type 26 SMF record
JBCPERFM
Default performance group
JBCCPBGN
Beginning of converter parameters
JBCCACCT
Accounting information flag
JBCCNONE
No information is required
JBCCNAME
Programmer required
JBCCNUMB
Account number required
JBCCALL
Programmer and account number required
JBCCSWAL
SWA above 16M line
JBCCTIME
Default job step interval time
JBCCMNTE
Maximum minutes
JBCCSECS
Maximum seconds
JBCCREGN
Default job step region
JBCCRGN
Numeric specification
JBCCRGA
Kilobytes or megabytes specification
JBCCMND
Command disposition
JBCCEXEC
Pass the command through
JBCCDSPL
Display and then pass command
JBCCVER
Ask operator disposition
JBCCIGN
Ignore the command
JBCCBLP
Bypass label processing option
JBCCBLPY
Process bypass label parm
JBCCOCG
Operator command group
JBCCGSYS
Group 1 commands (SYS)
JBCCGIO
Group 2 commands (I/O)
JBCCGCON
Group 3 commands (CONS)
JBCCGALL
All command groups
JBCCLJCL
Default MSGLEVEL, JCL listed if not MSGLEVEL
JBCCTMSG
Allocation termination messages
JBCCONVP
End of converter parameters
JBCOPSWT
Converter option switches
JBCFLAG1
Normal OUTDISP for JESDS
JBC1CDP
Conditionally purge output for jobs in this class
JBC1NODP
NORMAL OUTDISP=PURGE
JBC1NODW
NORMAL OUTDISP=WRITE
JBC1NODH
NORMAL OUTDISP=HOLD
JBC1NODK
NORMAL OUTDISP=KEEP
JBC1NODL
NORMAL OUTDISP=LEAVE
JBCFLAG2
Abnormal OUTDISP for JESDS
JBC1AODP
ABNORMAL OUTDISP=PURGE
JBC1AODW
ABNORMAL OUTDISP=WRITE
JBC1AODH
ABNORMAL OUTDISP=HOLD
JBC1AODK
ABNORMAL OUTDISP=KEEP
JBC1AODL
ABNORMAL OUTDISP=LEAVE
JBCFLAG3
Processing flags
JBC3WLM
WLM managed class
JBC3SPEC
Special class (STC/TSU)
JBC3PSEU
Pseudo class (Only class name and counts valid)
JBC3SINV
Default SCHENV (CATSCHED) no longer defined
JBC3DUOK
Duplicate job names OK for this job class
JBCXBM
PROCNAME for XBM II job
JBCCLASS
Job class
JBCMAXJ
Maximum executing jobs in this class in the JESPLEX
JBCCURJ
Current executing job in this class in the JESPLEX
JBCQSIZE
Jobs eligible for execution (including executing jobs)
JBCHLDCT
Jobs held in class (not including executing jobs)
JBCTSIZ1
Version 1 job class length
JBCDSCHE
Default SCHENV, Job classes only
JBCDMCLS
Default MSGCLASS, TSU and STC classes only
JBCSIZ2
Version 2 job class length
JBCJLOG
JESLOG control information
JBCLFLG
Flags
JBJLELIG
Spin eligible
JBJLTIMI
Spin on time interval
JBJLTIMD
Spin on time of day
JBJLLINE
Spin upon line delta
JBJLSUP
Suppress
JBJLNOSP
No spin
JBJSOURC
Source of JESLOG info
JBJSEXIT
JESLOG from Exit
JBJSJCL
JESLOG from JCL
JBJSCAT
JESLOG from CAT
JBJSSRR
JESLOG from IEFSSRR
JBCJLVAL
Spin value
JBCTSIZ3
Version 3 job class length
JBCTSIZ4
Version 4 job class length
JBCTSIZE
Job class data length
Member specific attribute prefix section (mapped by JBCLMEMD DSECT):
Field Name
Description
JBCMLEN
Length of member specific section (prefix + data)
JBCMTYPE
Type of this section (JBCLTMEM)
JBCMMOD
Modifier
JBCMFRST
First member section offset
JBCMCNT
Count of member entries
JBCMMLEN
Length of a member entry
JBCM1ST
Beginning of first member entry
JBCMSIZE
Size of fixed length prefix
Member specific attribute data section (mapped by JBCLMEME DSECT):
Field Name
Description
JBCMNAME
JES2 member name
JBCMSYS
MVS™ system name
JBCMFLG1
Member flags
JBCM1JBA
Jobclass active on member
JBC1ACT
Member is active
JBC1PXQ
$P XEQ issued on member
JBC1PJS
Member is draining ($P)
JBCMJMAX
Maximum jobs active
JBCMJACT
Current jobs active
JBCMESIZ
Member entry data section length

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014