Supplying the call parameters
Before a function is called, the caller must supply certain fields of the parameter structures, depending on the function to be called. In the description of each function, the fields to be supplied are listed in the table of call parameters. The sequence of the fields in this table must be adhered to.
Return parameters
After a function has been called, return parameters (return codes, MSG codes) are written to certain fields of the parameter structures, depending on the function called. The relevant fields are listed in the table of return parameters in the descriptions of the individual functions.
Return codes
The return code comprises one character and states whether a function has been executed successfully.
Detailed information can be obtained from the DMS, LMS and PLAM message codes. These message numbers are hex codes and must be interpreted as such. The DMS codes are displayed in decimal code already and can be evaluated directly, whereas the LMS and PLAM codes still have to be converted from hexadecimal to decimal for evaluation by /HELP.
The following return codes are passed at the subroutine interface:
Return code | Meaning |
X'00' | The function has been successfully executed. |
X'04' | The record buffer defined in GET is too small (maximum record length 32 Kbytes |
X'08' | End of member/TOC reached. |
X'0C' | Function aborted due to a user error. |
X'14' | Call parameters errored or incomplete. |
X'18' | Illegal call sequence. |
X'1C' | Internal LMS error. |