Output parameters for the function routine are:

• SSOBRETN
• SSNU

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

SSNUOK (0)

The message was issued successfully. The SSNUERCD field contains a zero (SSNURQOK).

SSNUOKB (4)

The message was issued successfully but had a minor error. See the SSNUERCD field in the SSNU control block for the specific reason code.

SSNUERR (8)

The message was not issued. See the SSNUERCD field in the SSNU control block for the specific reason code.

SSNUNEX (12)

The value for SSOBRETN means that SSOBINDV does not point to a valid SSNU control block. For example, SSOBINDV can be zero or in JES2 the eyecatcher pointed to by SSOBINDV is not 'SSNU'.

SSNU Contents: The SSNUERCD (error code) field in the SSNU control block contains one of the following decimal values if the SSOBRETN field was set to either SSNUOKB or SSNUERR on return from the IEFSSREQ macro:

Value (Decimal)

Meaning

SSNURQOK (0)

The request was successful.

SSNUMSGT (4)

The request was successful, but the message text was truncated because it was too long.

SSNUEXC (8)

A user exit cancelled the request (JES2 only). In JES2, exit 42 may have requested the cancellation of the message.

SSNUNUSR (12)

An invalid user ID was specified (blanks or zeros).

SSNUINVD (16)

An invalid nodename was supplied. The message was not issued.

SSNUIVID (20)

An invalid identifier (SSNUID) was supplied. The message was not issued.

SSNUIVER (24)

An invalid version of the SSNU control block was supplied. The message was not issued. The value supplied in the SSNUVER field is not valid. Both JES2 and JES3 will issue this return value if SSNUVER is zero. JES3 will also issue this return value if SSNUVER is at a higher level than receiving JES can process (SSNUCVER).

SSNUNOST (28)

Storage in the processing subsystem was not available for the function. The message was not issued.

SSNUNOAU (32)

The supplied token failed an NJE WRITER class authorization call. The caller is not allowed to issue messages to the specified node. The message was not issued.

SSNUMSGE (36)

The supplied message address or length was not valid (address specified was zero). The message was not issued.

SSNUUNTK (40)

The request was successful, but the user token is not allowed for an unauthorized caller.

SSNUINVE (44)

Indicates an invalid extension (incorrect length) has been provided.

SSNUMEME (48)

An incorrect member name was specified in SSNUMEMB. The message was issued with a default member specification.