HP 3000 Manuals HP 3000 Manuals
Creating and Using UDCs
You can use a one-wordUser-Defined Command (UDC) to start Pass Thru,
instead of the long command string described in "Command Syntax for
Starting Pass Thru," earlier in this chapter. UDCs are easy to create
and are handy for repetitive tasks. This section tells you how to use
the MPE editor and the SETCATALOG command to create UDCs for starting
Pass Thru. The next section, "UDCs for Starting Pass Thru," gives
example UDCs that start Pass Thru for your own terminal, for someone
else's terminal, for a cluster of terminals, and for a printer.
Following are the steps for creating a UDC that starts Pass Thru:
1. 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.
2. 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
/
3. 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
4. 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.
5. 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 *****
6. 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
7. 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"
8. 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 //
9. Save your UDC file by entering the following editor command at the
slash prompt:
/KEEP udcfile
10. 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
11. Leave the editor by entering the following editor command at the
slash prompt:
/EXIT
12. 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.
Listed together, the lines that make up the preceding example look like
this: (The text that you enter is underlined.
:SETCATALOG
:EDITOR
HP32201A.07.17 EDIT/3000 MON AUG 20, 1990, 10:06 AM
(C) HEWLETT-PACKARD CO. 1985
/T UDCFILE
/ADD
1 SNAIMF
2 RUN TTSSON.PUB.SYS;&
3 INFO="CONFIG=SNAPU#IMFCLASS;DEVID=D;LDEV=0"
4 *****
5 //
/KEEP UDCFILE
/EXIT
END OF SUBSYSTEM
:SETCATALOG UDCFILE
Once the UDC is set, you can simply type SNAIMF, and a Pass Thru session
will be started for your terminal. Typing SNAIMF will have the same
effect as typing the MPE RUN command that you entered in the UDC file.
For more information about MPE commands and UDCs, see the MPE V Commands
Reference Manual or the MPE XL Commands Reference Manual.
The next section, "UDCs for Starting Pass Thru," gives example UDCs that
start Pass Thru for your own terminal, for someone else's terminal, for a
cluster of terminals, and for a printer.