When you enter a UR (User Read) command, the G1CPBNC user exit program is invoked with UXIT-FUNCTION set to UXIT-READ-FILE. The available functionality includes the following:
-
Select and read a record from a user file containing addresses which are to be supplied when the UR command is entered. The selected address is passed to the calling program through the UXIT-P9IN field. The user exit must enable for multiple terminal operators working at the same time.
-
The entire Command field containing the UR command is available to the G1CPBNC program so that additional user-defined parameters can be defined as part of the UR command. The Command field is passed from the calling program through the UXIT-COMMAND-LINE field.
-
Specify the message that appears on the terminal screen at the completion of the UR command in the UXIT-PROMPT-MESSAGE field.
-
Specify whether or not the Command field on the terminal screen is to be blanked-out upon completion of execution for the UR command. This is specified via the UXIT-COMMAND field.
-
Specify whether or not an audible alarm is to sound at the completion of execution for the UR command. This is specified via the UXIT-ALARM field.
-
Specify whether the cursor on the terminal screen is to be positioned on the address input lines or the Command field at the completion of execution for the UR command. Since CODE-1 Plus automatically performs an attempted match subsequent to a UR command, UXIT-CURSOR-CMD-ON-MTCH can be used to position the cursor on the command line (for an anticipated UW command) on a match or in the address area on a non-match or multiple. This is specified via the UXIT-CURSOR field.
-
In order to coordinate the execution of UR and UW commands, an area of statically allocated memory is made available that is specific to one individual terminal user. This area is UXIT-SAVE-AREA.