UDCs for Starting Pass Thru

• Your own terminal

• Someone else's terminal

• A cluster of terminals

• A printer

For Your Own Terminal

You can create a UDC to start Pass Thru on your own terminal by entering the following lines in your UDC file:

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

Be sure to replace "SNAPU#IMFCLASS" with the SNA node name and the SNA class name or security class name configured for SNA IMF on your system.

Once this UDC is set, you can start a Pass Thru session on your terminal by typing the following at the MPE colon prompt:

:PTMYTERM

This UDC uses the default values for format, priority, BLANKS, enhance, spriority, readto, TRACE, pfn, and LJ2.

For Someone Else's Terminal

The UDC that starts Pass Thru for your own terminal can be modified to start Pass Thru for another terminal. You just have to change the LDEV value. For example, the UDC to start Pass Thru for logical device 25 would look like this:

PTTERM25
RUN TTSSON.PUB.SYS;&
INFO="CONFIG=SNAPU#IMFCLASS;DEVID=D;LDEV=25"
**********

To start Pass Thru for logical device number 25, you would type the following at the MPE colon prompt:

:PTTERM25

You can also create a UDC with optional parameters. If you make certain parameters optional, you can use the same UDC to start Pass Thru for various devices just by entering different parameters when you enter the command. In the following example, CONFIG, DEVID, and LDEV are set up as optional parameters. The values in quotation marks are the defaults.

SNAIMF CONFIG="SNAPU#IMFCLASS",DEVID="D",LDEV="0"
RUN TTSSON.PUB.SYS;&
INFO="CONFIG=!CONFIG;DEVID=!DEVID;LDEV=!LDEV"
**********

After you have set the UDC, you can type

:SNAIMF

at the MPE colon prompt, and the values in quotation marks will be used for the CONFIG, DEVID, and LDEV parameters. A Pass Thru session will be started for your own terminal, because the default LDEV value is 0. However, you can change the default parameter values by typing different ones when you enter the command. For example, to start Pass Thru for logical device 25, just enter

:SNAIMF LDEV=25

and Pass Thru will begin on the terminal associated with logical device 25.

For a Cluster of Terminals

You can create a UDC to start Pass Thru for a cluster of terminals or a cluster of printers. All devices in a cluster must be the same type (either all printers or all terminals). The following UDC starts Pass Thru for the terminals associated with logical device numbers 25 through 30:

PTCLUSTR
RUN TTSSON.PUB.SYS;&
INFO="CONFIG=SNAPU#IMFCLASS;DEVID=D;&
LDEV=25,26,27,28,29,30"
**********

After the UDC is set, you can type

:PTCLUSTR

and Pass Thru will start for logical devices 25 through 30. With this type of UDC, you can bring up all the terminals on a node with a single command.

This UDC uses the default values for format, priority, BLANKS, enhance, spriority, readto, TRACE, pfn, and LJ2.

You can also use the UDC with the optional parameters to start Pass Thru for a cluster of devices:

SNAIMF CONFIG="SNAPU#IMFCLASS",DEVID="D",LDEV="0"
RUN TTSSON.PUB.SYS;&
INFO="CONFIG=!CONFIG;DEVID=!DEVID;LDEV=!LDEV"
**********

To start Pass Thru for the cluster of devices associated with logical device numbers 25 through 30, enter the following command at the MPE colon prompt:

:SNAIMF LDEV="25,26,27,28,29,30"

For a Printer

The following UDC starts Pass Thru for the printer associated with logical device number 6:

PRTRUP CONFIG="SNAPU#IMFCLASS",DEVID="P",LDEV="6"
RUN TTSSON.PUB.SYS;&
INFO="CONFIG=!CONFIG;DEVID=!DEVID;LDEV=!LDEV"
**********

This UDC uses the default values for format, priority, BLANKS, enhance, spriority, readto, TRACE, pfn, and LJ2.

If you enter only

:PRTRUP

at the MPE colon prompt, a Pass Thru session will be started for the printer associated with logical device number 6. However, you can use the same UDC to start Pass Thru for a different printer by specifying a different logical device number when you enter the command. For example, to start Pass Thru for the printer associated with logical device number 8, you would enter the following command:

:PRTRUP LDEV=8