GXLSTRI — StringID service for Language Environment and Metal C

Description

This service provides a combination Language Environment® and Metal C StringID service exit for the z/OS XML parser and the OSR generator.

Performance Implications

There are no performance implications.

Syntax

call gxlstri,(sys_svc_parm,
              string,
              str_len,
              stringID,
              ccsid,
              diag_code,
              return_code)

Parameters

sys_svc_parm

Supplied parameter

Type:: Address
Length:: Fullword (Doubleword)

A pointer to the address of the storage to be used for this exit.

string

Supplied parameter

Type:: Character string
Length:: determined by the str_len parameter

The string passed in from the OSR generator.

str_len

Supplied parameter

Type:: Integer
Length:: Fullword

The value of the string length passed in from the OSR generator.

stringID

Returned parameter

Type:: Unsigned integer
Length:: Fullword

The value of the StringID set by this exit.

ccsid

Supplied parameter

Type:: Integer
Length:: Fullword

The Coded Character Set Identifier passed in from the OSR generator.

diag_code

Returned parameter

Type:: Integer
Length:: Fullword

The diagnostic code set by this exit.

return_code

Returned parameter

Type:: Integer
Length:: Fullword

The return code set by this exit.

Return Codes:

The z/OS XML parser uses the convention that the exit will provide a return code value of zero when successful. Any nonzero value indicates failure. If a nonzero return code is provided by the exit, the z/OS XML parser saves it in the extended diagnostic area so that the caller of the parser has access to it by calling GXL1CTL (GXL4CTL).

Example

For an example of using this exit service, see GXLESTRI.

Default Implementation

There is no default implementation.