XEC_CTL_ENTS_AND_REFS

Description

This indicates that the caller is requesting additional flexibility when processing character or entity references. When this option is specified, the ctl_data parameter must also be utilized to specify the specific enhancement being requested. See the ctl_data section below for more information.

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 a fullword containing an integer value initialized to XEC_CTL_ENTS_AND_REFS.

ctl_data

Supplied and returned parameter

Type:: Address
Length:: Fullword (Doubleword)

This parameter must contain the address of an area that contains information about what reference operations are to be processed. This area is mapped by the XEAR data structure in file GXLYCTL.

return_code

Returned parameter

Type:: Integer
Length:: Fullword

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

reason_code

Returned parameter

Type:: Integer
Length:: Fullword

The name of the 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.