Activating CODES File Changes for ROC

Applications that are using ROC reads the CODES file when one of the following occur:

The NGEN28/1/LIBRARY is initiated.
The NGEN28/1/LIBRARY is prompted to update the current files.

You can open or reload, and close the CODES file while the NGEN28/1/LIBRARY is running, by using the following types of commands:

AX (Accept) commands, entered from an ODT terminal
External Class Method Invocation (to provide a programmatic interface)

Refer to the following subsections for more information on these types of commands.

Activating Changes from an ODT Terminal

The NGEN28/1/LIBRARY is a Control Library that is an active stack that can process your commands. You can use an AX ODT command to initiate the reload process.

To use an AX command, from an ODT terminal, enter one of the following:

          mix AX CLOSE CODES

The mix value is the mix number of the NGEN28/1/LIBRARY. (You can find this number by using the LIBS command from the MARC screen.)

Note: There might be several NGEN28/1/LIBRARY files active; ensure that you obtain the mix number of the most recently initiated.

If an invalid AX command is entered, the following error message is displayed and the command is discarded.

COMMAND NOT RECOGNIZED: command

If a valid CLOSE CODES command is entered, the new CODES file is read and loaded into memory. The new information from the CODES file becomes available immediately. The following acknowledgement message is displayed in response:

CLOSE CODES PROCESSED

Activating Changes by Using a Programmatic Interface

A function in the NGEN28/1/LIBRARY provides a programmatic interface for acceptance of your user commands.

Details of the programmatic interface are as follows:

EntryPoint: 				ODTCOMMAND
Parameters: 				One
Parameter type: 		EBCDIC Array (A COBOL 01 Data Item)
Parameter contents 	"CLOSE CODES"
Library:					 NGEN28SERVICES (SL Library)
Parameter response:	" " (in first 5 characters) if successful
								"*****" (in first 5 characters) if error detected

The COBOL 01 attribute must be at least as long as the command.

The commands are free-format, and extraneous space characters are permitted anywhere between words.

This Library entry point might be invoked from a user program, or from a Ispec or Report by using an External Class Method Invocation.

Examples

The following example shows the programmatic interface in logic:

NGEN28SERVICES_Lib.FN(GLB.PARAM)
Move "CLOSE CODES" GLB.PARAM
NGEN28SERVICES_Lib.ODTCOMMAND(GLB.PARAM)

The following example shows the programmatic interface in COBOL74/COBOL85:

CHANGE ATTRIBUTE LIBACCESS OF
"NGEN28SERVICES" TO BYFUNCTION
MOVE "CLOSE CODES" TO 01-dataname
CALL "ODTCOMMAND IN NGEN28SERVICES"
USING 01-dataname.

For subsystems that use ROC, the CODES file is loaded when you use the CLOSE CODES command. Refer to Activating CODES File Changes for ROC for more information.