Output parameters for the function routine are:

• SSOBRETN
• SSSFREAS
• SSSFMREA
• SSSFMREA

SSOBRETN Contents: When control returns to the caller and register 15 contains a zero, the SSOBRETN field contains one of the following decimal values:

Value (Decimal)

Meaning

SSSFOK (0)

Request processed successfully.

SSSFUERR (8)

Request rejected, see reason code in field SSSFREAS.

SSSFEXTE (12)

No extension found.

SSSFNOST (16)

No storage to process request.

SSSFREAS Contents: When control returns to the caller and field SSOBRETN = SSSFUERR (8), the SSSFREAS field contains one of the following decimal values:

Value (Decimal)

Meaning

SSSFNOJ2 (16)

JES2 not up and running.

SSSFINVF (20)

Invalid function request.

SSSFINVE (24)

Invalid SSSF extension.

SSSFNOAU (32)

No authorization for request.

SSSFINRI (36)

Error processing request. See reason code in field SSSFMREA for SWB modify function or SSSFFREA for SWB merge/SWB merge cleanup functions.

SSSFEXC (40)

Exit cancelled request.

SSSFDISA (44)

Scheduler Services disabled.

SSSFGLBL(48)

Insufficient Global Level

SSSFMREA Contents: For the SWB modify function, when control returns to the caller and field SSSFREAS = SSSFINRI (36), the SSSFMREA field contains one of the following decimal values:

Value (Decimal)

Meaning

SSSFMOK (0)

Modify processing successful.

SSSFMTUE (4)

Modify/Erase TU error.

SSSFMJBE (8)

Modify jobname/jobid error.

SSSFMGRP (12)

Modify groupname error.

SSSFMNOS (16)

No storage to process request.

SSSFMSCI (20)

Invalid security request (SSSFFLG1).

SSSFMIVX (24)

Invalid modify extension.

SSSFMTKE (28)

Modify data set token error.

SSSFMNTK (32)

No data set token provided.

SSSFMJNF (36)

Job not found.

SSSFMDNF (40)

Data set not found.

SSSFMDSB (44)

Data set busy.

SSSFMDSQ (48)

Data set on BDT or TCP queue.

SSSFMDSF (52)

Data set referenced by JECL FORMAT statement.

SSSFMSJF (56)

SJFREQ (MERGE) error.

SSSFMSPC (60)

SWBTUREQ (SPLICE) error.

SSSFMSPT (64)

SWBTUREQ (SPLIT) error.

SSSFMSTU (68)

SWBTUREQ (RETRIEVE) error.

SSSFMSPL (72)

Spool I/O error.

SSSFMTNU (76)

Token not usable for requested function.

SSSFFREA Contents: When control returns to the caller of SWB merge/SWB merge cleanup function and the field SSSFREAS = SSSFINRI (36), the SSSFFREA field contains one of the following decimal values:

SSSFFOK (0)

Check the SSSFWRTN and SSSFWRSN fields for information.

SSSFFDST (4)

Data set token not given

SSSFFDSG (8)

Data set gone

SSSFFDSV (12)

Failure obtaining checkpoint version (JES2 only)

SSSFFJBG (16)

Job gone

SSSFFSWI (20)

Invalid SWBTU buffer

SSSFFDSE (24)

Invalid data set token

SSSFFGTE (28)

Invalid group token

SSSFFNOS (32)

No storage to process request

SSSFFSPL (36)

Spool I/O error

SSSFFTNU (40)

Token not usable for requested function

SSSFFDSQ (48)

Data set on BDT/TCP queue

SSSFFDSF (52)

Data set referenced by JECL FORMAT statement

When control returns to the caller of the SWB merge function:

SSSFFSWT

Token to be used by the calling program for SJFREQ services.

SSSFFSWU

Address of the SWBTU buffer.

SSSFFREA

Error reason code for Merge. Reported values are defined above.

SSSFWRTN

Return code from SWB services.

SSSFWOK (0)

Success

SSSFWERR (4)

Failed, see SSSFWRSN for the exact reason

SSSFWRSN

Reason code for SWB services failure SSSSCCRR where SSSSCCRR is defined as:

SSSS

Reason code from SJF service RR or a qualifier for a JES service error.

CC

Return code from SJF service RR. CC=00 if RR is 4 or 8.

RR

Indicates the SJF service or JES service.

• 4 = JES SPOOL I/O Error
• 8 = JES Memory Management Error
• 12 = SWB_MERGE
• 16 = PUTSWB
• 20 = JDTEXTRACT
• 24 = SWBTUREQ RETRIEVE
• 28 = SWBTUREQ SPLICE
• 32 = SWBTUREQ SPLIT

SSSFRFLG

Returned flag byte.

SSSFFIPA

IP address available in SWBTU buffer.