XEC_CTL_LOAD_OSR

Description

This indicates that the caller wants to load and use a given Optimized Schema Representation (OSR) during a validating parse. If the parse prior to invoking this operation returned a XRSN_NEED_OSR, this operation will not perform reset and finish processing.

Syntax

call gxl1ctl,(PIMA,
              ctl_option,
              ctl_data,
              return_code,
              reason_code);

Parameters

PIMA

Supplied parameter

Type:: Character string
Length:: Variable

The name of the Parse Instance Memory Area (PIMA) which has been previously initialized with a call to the initialization service.

ctl_option

Supplied parameter

Type:: Integer
Length:: Fullword

The name of fullword containing an integer value initialized to XEC_CTL_LOAD_OSR.

ctl_data

Supplied and returned parameter

Type:: Address
Length:: Fullword (Doubleword)

This indicates that the caller wants to load and use a given Optimized Schema Representation (OSR) during a validating parse. Once an OSR has been loaded, it remains in use for all validating parse requests until a different OSR is provided by calling this service again.

This parameter must contain the address of an area containing information about the OSR to load. This area is mapped by GXLYXOSR. See gxlhxosr.h (GXLYXOSR) - mapping of the OSR control area for more information about the macro.

return_code

Returned parameter

Type:: Integer
Length:: Fullword

The name of a fullword where the service stores the return code.

reason_code

Returned parameter

Type:: Integer
Length:: Fullword

The name of a fullword where the service stores the reason code. The reason code is only relevant if the return code is not XRC_SUCCESS.

All parameters in the parameter list are required.