When you enter a UW (User Write) command, the G1CPBNC user exit program is invoked with UXIT-FUNCTION set to UXIT-WRITE-FILE.
The results from attempting to match the address currently on the terminal screen are passed to the user exit in the UXIT-P9OUT and UXIT-P9AUDT fields. The user exit should determine whether to accept the address and write it to a user file containing corrected addresses or reject the address and display an error message on the terminal screen. The user exit must enable for multiple terminal operators working at the same time.
-
The entire Command field containing the UW command is available to the G1CPBNC program so that additional user-defined parameters can be defined as part of the UW command. The Command field is passed from the calling program through the UXIT-COMMAND-LINE field.
-
Specify the message which appears on the terminal screen at the completion of the UW 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 UW 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 UW command. This is specified via the UXIT-ALARM field.
-
Specify whether or not to clear the address input fields on the terminal screen at the completion of execution for the UW command. This is specified via the UXIT-ADDRESS 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 UW command. 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 and common to both the UR and UW commands. This area is UXIT-SAVE-AREA.