SCLM service return codes

Each service returns a numeric code, called a return code, indicating the results of the operation. Here are possible return codes:

0: Indicates successful completion. SCLM may generate messages.
2: Indicates successful completion. No action taken.
4: Indicates a warning condition. SCLM may generate messages.
8: Indicates an error condition. SCLM generates messages detailing the error.
12: Indicates a severe error condition. SCLM generates messages detailing the error.

Return codes and their meanings vary for each service and are listed with each service description. In addition to these return codes, the FLMCMD and FLMLNK interfaces each generate return codes.

For command invocation, SCLM returns the code in the CLIST variable. For call invocation, SCLM returns the code in registers 15 and 0. When using the FILE format of FLMCMD command invocation, SCLM sets the return code to the maximum return code encountered while processing the command data set.

Programs coded in Pascal or FORTRAN can examine the return code by using an integer variable, such as lastrc, in the following example:

lastrc := FLMLNK(service_name,parameter1,parameter2,...);

Programs coded in PL/I can examine the return code by using PLIRETV, a built-in function. You need the following declare statements:

DECLARE FLMLNK  EXTERNAL ENTRY OPTIONS(ASM INTER RETCODE);
DECLARE PLIRETV BUILTIN;

Programs coded in COBOL can examine the return code by using RETURN-CODE, a built-in variable.