This example module does the following:
- Validates the caller specification and determines whether to use
user defined or default values for storage size.
- Initializes all variables in XSI. (XSI is the data structure for
the StringID sample exit).
Register 14 is used to store the return address, which
must be kept intact in order to exit this subroutine correctly.
This
example module assumes register one, which is passed in from the caller,
contains the address of the parameter list. The following input variables
are used in the example:
- STRID_AREA_ADDR
- Address of the XSI storage area.
- STRID_AREA_LEN
- Total length of the XSI Storage area.
- STRID_MAX_NUM
- The maximum number of StringIDs allowed.
- SYM_MAX_SIZE
- The maximum string length for each symbol.
The following output variables are used in this example
module:
- RETCODE
-
- XSI_RC_FAILURE
- If the storage area failed to initialize.
- XSI_RC_SUCCESS
- If the storage area successfully initialized.
- DIAG_CODE
- Contains diagnostic information.
- XSI_DC_SYMBOL_STORAGE_TOO_SMALL
- Storage size is too small.