Creating and Using UDCs

If you already have a file that contains your UDCs, make it available for write access by entering the following command at the MPE colon prompt:

:SETCATALOG

You cannot modify your UDC file until you issue the SETCATALOG command. When you issue the SETCATALOG command without any parameters, it removes all your UDCs from the catalog.

Start the MPE editor by entering the following command at the colon prompt:

:EDITOR

The following message will appear on your screen, followed by a slash, which is the prompt for the MPE editor:

HP32201A.07.17  EDIT/3000  MON, AUG 20, 1990, 10:06 AM
(C) HEWLETT-PACKARD CO. 1985
/

If you already have a file containing your UDCs, call up the file by entering the following editor command at the slash prompt:

/T udcfile

To enter text into your file, type the following editor command at the slash prompt:

/ADD

If you are editing an existing UDC file, the line number that appears on your screen is the number of the first blank line at the end of the file. If you are creating a new UDC file, the number 1 appears on your screen, indicating that you are at the first line in the file.

UDCs in a file must be separated by a row of asterisks, so if you are editing an existing UDC file, type a row of asterisks on a line by itself. (In this example, the line number is 12.)

12  *****

Enter the name of the UDC you are creating. This is the command you will type to invoke the UDC. In the following example, the name of the UDC, and the command that invokes it, is SNAIMF. The line number in the example is 1, but if you are editing an existing UDC file, the line number will be the number of the first blank line at the end of the file.

1  SNAIMF

On the next line following the UDC name (or the next several lines), enter the command that invokes Pass Thru. The info string of the MPE RUN command can be up to 256 characters long, counting blanks.

You can break the RUN command up into several lines if you end each line with an ampersand (&). The ampersand causes line breaks to be ignored; lines separated by ampersands are read as one long line.

The following command starts Pass Thru for the terminal from which the command is issued. The SNA node name is SNAPU, and the SNA class name or security class name is IMFCLASS. The device ID is D (Display station), and the ldev number is 0, specifying the terminal from which the command is issued. All the other info string parameters have default values.

2  RUN TTSSON.PUB.SYS; &
3  INFO="CONFIG=SNAPU#IMFCLASS;DEVID=D;LDEV=0"

On the line following your UDC, type several asterisks to mark the end of the UDC. Then, on the next line, type 2 slashes to indicate that you are finished entering text.

4  *****
5  //

Save your UDC file by entering the following editor command at the slash prompt:

/KEEP udcfile

If you are editing an existing UDC file, the editor will ask you if you want to purge the old version and replace it with the edited version. Verify that you want to keep the edited file by entering YES.

PURGE OLD? YES

Leave the editor by entering the following editor command at the slash prompt:

/EXIT

Set the new udcfile by entering the following command at the MPE colon prompt:

:SETCATALOG udcfile

	NOTE: When you issue the SETCATALOG command with no arguments, it removes all your UDCs, in all your UDC files, from the catalog. To reset all your UDCs, you must issue the SETCATALOG command once for every file that contains UDCs.