PRTMAP statement

Use the optional PRTMAP mapping statement to define the mapping of a printer LU or group of printer LUs objects to a client identifier.

Syntax


                                                                .-GENERIC--.   
>>-PRTMAP--+-prt_name-------+--+-Client_Identifier-----------+--+----------+-->
           '-prt_group_name-'  '-clid_type,Client_Identifier-'  '-SPECIFIC-'   

>--+--------------------------------------------------------------------+-->
   '-DEFAPPL -application_name--+-----------+--+---------+--+---------+-'   
                                '-FIRSTONLY-'  +-LOGAPPL-+  '-DEFONLY-'     
                                               '-QINIT---'                  

                                .-KEEPOPEN-.   
>--+-------------------------+--+----------+-------------------><
   '-PMAP --parms_group_name-'

Parameters

prt_name: The name of the printer LU.
prt_group_name: The group name that contains the printer LUs.
clid_type: Specifies the type of Client Identifier. It is required if USERID or DESTIP are specified. See Rules for client identifier specification for details.
Client_Identifier: One of several client identifiers. See Client identifier types and definitions for details.
GENERIC: Indicates that the LU or PRTGROUP are checked for Generic connection requests. Generic mapping statements also support Specific connection requests if there is no LU or PRTGROUP mapped specifically to the client.
SPECIFIC: Indicates that the LU or PRTGROUP are checked for Specific connection requests. Specific mapping statements are not used for Generic connection requests.
DEFAPPL application_name: Specifying DEFAPPL indicates the initial application to which Telnet connects. The application_name can be network qualified in the format of a 1- to 8-character name of the network separated by a period (.), followed by a 1- to 8-character application name.
FIRSTONLY: When FIRSTONLY is specified, the printer LU remains active with an open ACB after initial session logoff from the default session. When FIRSTONLY is not specified, Telnet always requests a new session to the default application after logoff from the session when LUSESSIONPEND is coded. If LUSESSIONPEND is not coded, the connection is dropped.
LOGAPPL: When LOGAPPL is specified, a session request to a host application that is not active is queued in VTAM® instead of rejected. Telnet keeps the ACB open for the LU representing the client. When the application becomes active, VTAM initiates a session between the application and the Telnet LU.
QINIT: Indicates that session requests should be queued, and when logging off the default application, Telnet should redrive the default application instead of issuing a USSMSG10 or Solicitor screen.
DEFONLY: When DEFONLY is specified, the client is blocked from specifying any application name other than the one specified on the default application statement.
PMAP parms_group_name: Maps a ParmsGroup to an LU group. With this, parameters can be assigned based on the chosen LU name or group.
KEEPOPEN: Specifying KEEPOPEN means that all LUs identified in the lu_group_name or the LU identified by lu_name always have an OPEN ACB as long as the connection exists, whether or not a session exists. For printers, this option is always set. When KEEPOPEN is mapped to a connection, the MSG07 and LUSESSIONPEND functions are in effect whether or not they were explicitly coded.

Usage notes

A single Client Identifier can have several printer LU names or printer LU groups mapped to it. See the LU assignment information in the Telnet topic of the z/OS Communications Server: IP Configuration Guide.
See Rules for LU name specification for LU name specification rules.