z/OS Infoprint Server Operation and Administration
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


create and force-create—create an object

z/OS Infoprint Server Operation and Administration
SA38-0693-00

create and force-create—create an object

Format

create objectclass name [attribute = value]... ;

force-create objectclass name [attribute = value]... ;

Description

The create command creates an object in the Printer Inventory. The object must not already exist in the Printer Inventory.

The force-create command does the same function as the create command except that if an object of the same name already exists in the same object class, it is replaced.

You cannot use the create command to create the system configuration definition in the configuration class because Infoprint Server automatically creates this definition when Infoprint Server starts. However, if dynamic configuration is enabled, you can use the force-create command to replace all attributes in the system configuration definition.

Operands

objectclass
The class of the object that you want to create. For a list of the object classes, see Table 38.

You can specify the configuration class on a force-create command but not on a create command.

name
A name to identify the object. Objects in the same object class cannot have the same name. Also, a printer pool definition (printer-pool object class) cannot have the same name as a printer definition (printer object class).

When you create a printer definition, printer-pool definition, job selection rule, or component, specify any combination of 1-17 letters (a-z, A-Z), numbers (0-9), and special characters (such as $ # @ . - = /). Blank characters are not allowed. In an IP PrintWay™ printer definition, use name DFLTNTRY to designate the IP PrintWay default printer definition. The name is case-sensitive.

When you create an FSS or FSA definition, this name must match the name used to define the FSA or FSS to JES. Specify a valid combination of 1-8 letters, numbers, and national characters (# $ @). The first character cannot be numeric. Blanks and other special characters are not allowed. Lowercase letters are converted to uppercase.

If the name contains special characters, enclose the name in single or double quotation marks.

Tip: On a force-create command to replace the system configuration definition, specify aopd.conf as the name.

attribute = value
One or more attributes and values. Separate attributes with spaces. For the valid attributes for each object class, see Attribute listing.

Usage notes

  • A printer definition can include one or more components. For example, a printer definition can include one Allocation component and one Processing component. When a printer definition includes a component, the attributes specified for the component apply to the printer definition as well. To include a component, use the include-object attributes, such as include-allocation and include-processing.
  • When you create a printer definition and include components, you can override any attribute that is specified in a component. To do this, specify the same attribute on the create statement for the printer definition. The attribute you specify on the create statement applies only to the printer definition. The value of the attribute in the component is not changed.
    Tip:
    If an attribute is specified in a printer definition, and you later change the value for that attribute in an included component, the value in the printer definition remains unchanged.
  • You must create components before you create any printer definitions that include these components.
  • You must create printer definitions before you create any printer pool definitions that list these printer definitions.
  • To help you specify a valid create statement, first use the ISPF panels to create the object in the Printer Inventory and then use the PIDU display or export command to list the attributes for the object.
  • If you repeat the same attribute in a create statement, the PIDU program uses the last specification.

Examples -- create and force-create

You can find additional examples of PIDU commands in the file /usr/lpp/Printsrv/samples/sample.pidl

All of these examples also apply to the force-create command.

Creating an allocation component

This example creates an Allocation component named printway. This Allocation component might be included in all printer definitions for printers to be managed by the same IP PrintWay basic mode FSA.

pidu -c 'create allocation printway
         description="JES allocation values for IP PrintWay"
         output-class=K ; '

The attributes set in this component are:

  • description: This attribute describes the component.
  • output-class: This attribute specifies the output class that is the JES work-selection criterion for the IP PrintWay basic mode FSA. In this example, the output class is K. NetSpool and Print Interface will allocate output data sets on the JES spool in class K.
Creating a processing component for PCL printers

This example creates a Processing component named pcl_printer that contains attributes suitable for printers that can print PCL files:

pidu -c 'create processing pcl_printer
         description = "Generic PCL options"
         printer-codepage = ISO8859-1
         document-formats-supported = { text pcl modca-p line-data }
         filters = { text -> aopfiltr.so modca-p -> "afpxpcl.dll -c us"
                     line-data -> "afpxpcl.dll -c us" }
         pcl-print-density =  10
         pcl-line-density =  6 ; '

The attributes set in this component are:

  • description: This attribute describes the component.
  • printer-codepage: This attribute specifies ASCII code page ISO8859-1. Specify an ASCII code page so that Print Interface converts EBCDIC data to ASCII before writing data to the JES spool. NetSpool also converts data to this code page when the netspool-formatting=convert-to-pcl attribute is specified in the printer definition.
  • document-formats-supported: This attribute specifies that the printer accepts text, PCL, MO:DCA-P, and line data. The printer accepts MOD:CA-P and line data because a transform is associated with this data format in the filters attribute.
  • filters: This attribute requests that Print Interface use these filters:
    • aopfiltr.so filter for text data. IBM® suggests that you specify this filter for text data. aopfiltr.so is provided with Infoprint Server. For information about this filter, see Using the aopfiltr.so filter.
    • afpxpcl.dll filter for MO:DCA-P (AFP) data and line data. This filter transforms AFP and line data to PCL data.
  • pcl-print-density: This attribute specifies the number of characters per inch to be printed on a line. NetSpool uses this value when the netspool-formatting=convert-to-pcl attribute is also specified in the printer definition.
  • pcl-line-density: This attribute specifies the number of lines per inch to be printed on a page. NetSpool uses this value when the netspool-formatting=convert-to-pcl attribute is also specified in the printer definition.
Creating a processing component for AFP printers

This example creates a Processing component named afp_printer that contains attributes suitable for printing on AFP printers:

pidu -c 'create processing afp_printer
         description = "AFP options"
         printer-codepage = IBM-1047
         document-formats-supported = { modca-p line-data text pcl postscript pdf}
         filters = { pcl -> "pcl2afp.dll %filter-options"
                     postscript -> "ps2afp.dll %filter-options"
                     pdf -> "ps2afp.dll %filter-options"} ; '

The attributes set in this component are:

  • description: This attribute describes the component.
  • printer-codepage: This attribute specifies EBCDIC code page IBM-1047. Specify an EBCDIC code page so that Print Interface converts ASCII data to EBCDIC before writing data to the JES spool.
  • document-formats-supported: This attribute specifies that the printer accepts MO:DCA-P, line data, text, PCL, PostScript, and PDF data.
  • filters: This attribute requests that Infoprint Server use the pcl2afp.dll filter to transform PCL data to AFP format (MO:DCA-P) and the ps2afp.dll filter to transform both PostScript and PDF data to AFP format.
Creating an IP PrintWay options component

This example creates an IP PrintWay Options component named pcl_land_17cpi that contains attributes suitable for printing in the landscape orientation on PCL printers and for retaining data sets on the JES spool that IP PrintWay cannot transmit to the remote printer.

pidu -c 'create printway-options pcl_land_17cpi
         description = "PCL landscape 17 cpi"
         retry-limit = 5
         retry-time  = 5:00
         failure-retention-period = forever
         document-header = "<esc>E<esc>&l10<esc>(s17H"
         document-trailer = "<esc>E" ; '

The attributes set in this component are:

  • description: This attribute describes the component.
  • retry-limit: This attribute specifies that IP PrintWay is to retry unsuccessful transmissions up to 5 times before considering the transmission to have failed.
  • retry-time: This attribute specifies that IP PrintWay is to retry unsuccessful transmissions every 5 minutes. IP PrintWay also automatically retries an unsuccessful transmission right after the first transmission fails.
  • failure-retention-period: This attribute specifies that IP PrintWay retain the output data set on the JES spool if the transmission fails.
  • document-header: This attribute specifies printer commands for printing in the landscape direction. IP PrintWay translates the instructions to ASCII and transmits them to the printer before the data.
  • document-trailer: This attribute specifies printer commands to reset the printer to its original state. IP PrintWay translates the instructions to ASCII and transmits them to the printer after the data.
Creating a NetSpool options component for PCL printers

This example creates a NetSpool Options component named pcl. The attributes in this component request that NetSpool convert data to PCL before writing it to the JES spool.

pidu -c 'create netspool-options pcl
         description = "Convert to PCL"
         netspool-formatting = convert-to-pcl ; '

The attributes set in this component are:

  • description: This attribute describes the component.
  • netspool-formatting: This attribute requests that NetSpool convert data to PCL before writing it to the JES spool.
Creating a NetSpool options component to print binary data

This example creates a NetSpool Options component named binary. The attributes in this component request that NetSpool not convert or format data before writing it to the JES spool.

pidu -c 'create netspool-options binary
         description = "No formatting; 80 byte records"
         netspool-formatting = none
         maximum-record-size = 80
         recfm = vba ; '

The attributes set in this component are:

  • description: This attribute describes the component.
  • netspool-formatting: This attribute specifies that NetSpool not format data before writing it to the JES spool.
  • maximum-record-size: This attribute specifies that NetSpool write a maximum record size of 80 bytes.
  • recfm: This attribute specifies that NetSpool use a record format of VBA.
Creating a NetSpool end-of-file component

This example creates a NetSpool End-of-File component named bracket. The attributes in this component tell NetSpool to use the end-of-bracket rule to determine when to close the output data set on the JES spool, and also request that NetSpool delete form feed controls that occur at the end of the output data set.

pidu -c 'create netspool-eof-rules bracket
         description="Bracket rule; delete trailing form feeds"
         eof-rules={
         default={ all -> {eof-method=end-bracket delete-form-feed=trailing} }
        } ; '

The attributes set in this component are:

  • description: This attribute describes the component.
  • eof-rules: This attribute specifies the start of the end-of-file rules.
  • default: This attribute defines default end-of-file rules that apply to all LU types.
  • eof-method: This attribute requests that NetSpool use the end-of-bracket rule.
  • delete-form-feed: This attribute requests that NetSpool delete form feed controls at the end of the output data set.
Creating a protocol component for LPR protocol

This example creates a Protocol component named lpr_options that contains attributes suitable for transmitting data sets using IP PrintWay and the LPR to LPD protocol.

pidu -c 'create protocol lpr_options
         description = "LPR to PASS queue"
         protocol-type = lpr
         print-queue-name = PASS ; '

The attributes set in this component are:

  • description: This attribute describes the component.
  • protocol-type: This attribute requests the LPR to LPD protocol.
  • print-queue-name: This attribute specifies the name of the PASS print queue on the target printer.
Creating an IP PrintWay printer definition for a PCL printer with LPR protocol

This example creates a printer definition named lp1 for a printer managed by IP PrintWay. IP PrintWay uses the LPR to LPD TCP/IP protocol to transmit data to the remote printer or print server.

pidu -c 'create printer lp1
         description = "Default printer"
         location = "Printer room"
         printer-type = ip-printway
         dcf-routing = yes
         destination = LP1
         printer-ip-address = printer1.boulder
         luname = LUPRT001
         lu-classes = { 2 }
         default-owner = smith
         embedded-attributes-prefix = "<<ibmjobattr"
         operator-security-profile = "DENVER.001"
         include-allocation = printway
         include-processing = pcl_printer
         include-printway-options = pcl_land_17cpi
         include-netspool-options = pcl
         include-netspool-eof-rules = bracket
         include-protocol = lpr_options ; '

Users can access this printer definition in these ways:

  • Local and remote can users use lp1 as the name of the destination, print queue, or printer definition.
  • IPP clients can use one of these URIs:
    • ipp://host/servlet/IPPServlet/lp1
    • http://host:631/servlet/IPPServlet/lp1
    The host name or IP address of the z/OS system is host.
  • JCL users can specify either (1) FSSDATA='printer=lp1' or (2) CLASS=K and DEST=LP1 on an OUTPUT JCL statement. JCL users can also use the AOPPRINT procedure, specifying lp1 as the printer name.
  • VTAM® applications use NetSpool printer LU name LUPRT001.

The attributes set in this printer definition are:

  • description: This attribute describes the printer definition.
  • location: This attribute describes the location of the printer.
  • printer-type: This attribute specifies that IP PrintWay manages the printer.
  • dcf-routing: This attribute specifies that users can select this printer using the DEST, CLASS and FORMS parameters on an OUTPUT JCL statement. In this example, the DEST value is specified in the destination attribute, the CLASS value is specified in the included Allocation component named printway, and the FORMS value is not specified.
  • destination: This attribute specifies that Print Interface and NetSpool allocate output data sets on the JES spool with a DEST value of LP1. Because dcf-routing=yes, IP PrintWay selects this printer definition when the OUTPUT JCL statement contains a DEST value of LP1 and a CLASS value of K.
  • printer-ip-address: This attribute specifies the IP address of the remote printer or print system.
  • luname: This attribute specifies the NetSpool printer LU name.
  • lu-classes: This attribute assigns the NetSpool printer LU name to LU class 2.
  • default-owner: This attribute specifies the default Infoprint Server job owner for data sets that NetSpool spools for the associated logical unit (LU) if embedded job attributes in the print data do not specify an owner.
  • embedded-attributes-prefix: This attribute specifies, for data sets that NetSpool spools, the prefix that identifies job attributes embedded in the print data.
  • operator-security-profile: This attribute controls who can work with this printer using Infoprint Central.
  • include-object: These attributes include components in the printer definition. All attributes specified in the named components apply to this printer definition. You must create components printway, pcl_printer, pcl_land_17cpi, pcl, bracket, and lpr_options.
Creating an IP PrintWay printer definition for a PCL printer with IPP protocol

This example creates a printer definition named lab_printer for a remote printer to which IP PrintWay transmits data. IP PrintWay uses Internet Printing Protocol (IPP) to transmit data to an IPP server running on the remote printer or print server.

pidu -c 'create printer lab_printer
         description = "IPP printer in 004 lab"
         location = "Lab printer room - building 004"
         printer-type = ip-printway
         dcf-routing = yes
         destination = LAB
         luname = LUPRT003
         lu-classes = { 2 }
         default-owner = smith
         embedded-attributes-prefix = "<<ibmjobattr"
         operator-security-profile = "DENVER.001"
         protocol-type = ipp
         printer-uri = "ipp://myprinter.xyz.com"
         include-allocation = printway
         include-processing = pcl_printer
         include-printway-options = pcl_land_17cpi
         include-netspool-options = pcl
         include-netspool-eof-rules = bracket ; '

Users can access this printer definition in these ways:

  • Local and remote users can use lab_printer as the name of the destination, print queue, or printer definition.
  • IPP clients can use one of these URIs:
    • ipp://host/servlet/IPPServlet/lab_printer
    • http://host:631/servlet/IPPServlet/lab_printer
    The host name or IP address of the z/OS system is host.
  • JCL users can specify either (1) FSSDATA='printer=lab_printer' or (2) CLASS=K and DEST=LAB on an OUTPUT JCL statement. JCL users can also use the AOPPRINT procedure, specifying lab_printer as the printer name.
  • VTAM applications use NetSpool printer LU name LUPRT003.

The attributes set in this printer definition are:

  • description: This attribute describes the printer definition.
  • location: This attribute describes the location of the printer.
  • printer-type: This attribute specifies that IP PrintWay manages the printer.
  • dcf-routing: This attribute specifies that users can select this printer using the DEST, CLASS, and FORMS parameters on an OUTPUT JCL statement. In this example, the DEST value is specified in the destination attribute, the CLASS value is specified in the Allocation component named printway, and the FORMS value is not specified.
  • destination: This attribute specifies that NetSpool and Print Interface allocate output data sets on the JES spool with a DEST value of LAB. Because dcf-routing=yes, IP PrintWay selects this printer definition when the OUTPUT JCL statement contains a DEST value of LAB and a CLASS value of K.
  • luname: This attribute specifies the NetSpool printer LU name.
  • lu-classes: This attribute assigns the NetSpool printer LU name to LU class 2.
  • default-owner: This attribute specifies the default Infoprint Server job owner for data sets that NetSpool spools for the associated logical unit (LU) if embedded job attributes in the print data do not specify an owner.
  • embedded-attributes-prefix: This attribute specifies, for data sets that NetSpool spools, the prefix that identifies job attributes embedded in the print data.
  • operator-security-profile: This attribute controls who can work with this printer using Infoprint Central.
  • protocol-type: This attribute requests that IP PrintWay use Internet Printing Protocol (IPP) to transmit data to the printer.
  • printer-uri: This attribute specifies the Uniform Resource Identifier (URI) of the remote printer.
  • include-object: These attributes include components in the printer definition. All attributes specified in the named components apply to this printer definition. The named components were created in previous examples.
Creating an IP PrintWay printer definition for an SCS printer with VTAM protocol

This example creates a printer definition named scs_printer for a remote printer to which IP PrintWay transmits data. IP PrintWay uses VTAM to transmit data to the SCS printer.

pidu -c 'create printer scs_printer
         description = "SCS printer"
         location = "Building 005"
         printer-type = ip-printway
         printer-codepage = IBM-1047
         dcf-routing = yes
         destination = scsprt
         operator-security-profile = "DENVER.001"
         protocol-type = vtam
         printer-luname = p001
         printer-logmode = scs
         vtam-checkpoint-pages = 10
         printway-formatting = use-fcb
         scs-top-margin = 6
         scs-bottom-margin = 62
         scs-left-margin = 11
         scs-right-margin = 71
         scs-maximum-line-length = 80
         scs-maximum-page-length = 66
         include-allocation = printway ; '

Users can access this printer definition in these ways:

  • Local and remote users can use scs_printer as the name of the destination, print queue, or printer definition.
  • IPP clients can use one of these URIs:
    • ipp://host/servlet/IPPServlet/scs_printer
    • http://host:631/servlet/IPPServlet/scs_printer
    The host name or IP address of the z/OS system on which Infoprint Server is running is host.
  • JCL users can specify either (1) FSSDATA='printer=scs_printer' or (2) CLASS=K and DEST=SCSPRT on an OUTPUT JCL statement. JCL users can also use the AOPPRINT procedure, specifying scs_printer as the printer name.

The attributes set in this printer definition are:

  • description: This attribute describes the printer definition.
  • location: This attribute describes the location of the printer.
  • printer-codepage: This attribute specifies EBCDIC code page IBM-1047. Specify an EBCDIC code page so that Print Interface and IP PrintWay convert ASCII data to EBCDIC. Most SCS printers accept EBCDIC data.
  • printer-type: This attribute specifies that IP PrintWay manages the printer.
  • dcf-routing: This attribute specifies that users can use the DEST, CLASS, and FORMS parameters on an OUTPUT JCL statement to select this printer definition. In this example, the DEST value is specified in the destination attribute, the CLASS value is specified in the Allocation component named printway, and the FORMS value is not specified.
  • destination: This attribute specifies that Print Interface allocate output data sets on the JES spool with a DEST value of SCSPRT. Because the dcf-routing=yes attribute is specified, IP PrintWay uses this printer definition for all data sets on the JES spool with a DEST value of SCSPRT and a CLASS value of K.
  • operator-security-profile: This attribute controls who can work with this printer using Infoprint Central.
  • protocol-type: This attribute requests that IP PrintWay use VTAM to transmit data to the printer.
  • printer-luname: This attribute specifies the name of the remote SCS printer as defined to VTAM.
  • vtam-checkpoint-pages: This attribute specifies that IP PrintWay will request a definitive response from the printer every 10 pages.
  • printway-formatting: This attribute specifies that the FCB, if specified, is used to create the SCS data stream.
  • scs-xxxx: These attributes specify formatting values.
  • include-allocation: This attribute includes the previously defined allocation component named printway. See Creating an allocation component.
Creating an IP PrintWay printer definition for the email protocol

This example creates a printer definition named deptmail and selects the email protocol:

pidu -c 'create printer deptmail
         description = "Email destination"
         location = "Departments 01 and 02"
         printer-type = ip-printway
         printer-codepage = IBM-1047
         dcf-routing = yes
         destination = DEPTMAIL
         protocol-type = email
         title-text = "My default email title"
         mail-bcc-addresses = {"user2@xyz.com" dept01list}
         mail-cc-addresses = {"user3@xyz.com" dept02list}
         mail-from-name = "John Q. Sender"
         mail-reply-address = {"mysecretary@xyz.com"}
         mail-to-addresses = {"user1@xyz.com" dept03list}
         luname = DEPTMAIL
         lu-classes={ 1 }
         default-owner = smith
         embedded-attributes-prefix = "<<ibmjobattr"
         printway-formatting = use-fcb
         print-page-header = no
         dataset-grouping = concatenate-job
         include-allocation = printway ; '

Users can access this printer definition in these ways:

  • Local and remote users can use deptmail as the name of the destination, print queue, or printer definition.
  • IPP clients can use one of these URIs:
    • ipp://host/servlet/IPPServlet/deptmail
    • http://host:631/servlet/IPPServlet/deptmail
    The host name or IP address of the z/OS system is host.
  • JCL users can specify either (1) FSSDATA='printer=deptmail' or (2) CLASS=K and DEST=DEPTMAIL on an OUTPUT JCL statement. Users of the AOPPRINT procedure specify deptmail as the printer name.

The attributes set in this printer definition are:

  • description: This attribute describes the printer definition.
  • location: This attribute describes the email destination.
  • printer-type: This attribute specifies IP PrintWay.
  • printer-codepage: This attribute specifies EBCDIC code page IBM-1047. Specify an EBCDIC code page so that Print Interface and IP PrintWay convert ASCII text data to EBCDIC.
  • dcf-routing: This attribute specifies that job submitters can use the DEST, CLASS, and FORMS parameters on an OUTPUT JCL statement to select this printer definition. In this example, the DEST value is specified in the destination attribute, the CLASS value is specified in the Allocation component named printway, and the FORMS value is not specified.
  • destination: This attribute specifies that Print Interface and NetSpool allocate output data sets on the JES spool with a DEST value of DEPTMAIL. Because the dcf-routing=yes attribute is specified, IP PrintWay uses this printer definition for all data sets on the JES spool with a DEST value of DEPTMAIL and a CLASS value of K.
  • protocol-type: This attribute requests that IP PrintWay use the email protocol.
  • title-text: This attribute specifies a default subject for emails.
  • mail-bcc-addresses: This attribute specifies the email addresses of the “blind copy (bcc)” recipients of the email. A bcc means that other recipients of the email do not see the bcc recipient listed. One email address and one z/OS UNIX sendmail alias name are specified.
  • mail-cc-addresses: This attribute specifies the email addresses of the “copy (cc)” recipients of the email. A cc means that other recipients of the email can see the cc recipient listed. One email address and one z/OS UNIX sendmail alias name are specified.
  • mail-from-name: This attribute specifies the descriptive name or other identifier of the sender of the email.
  • mail-reply-address: This attribute specifies the email address that recipients of the email can reply to. If this attribute is omitted, most email programs use the sender's email address. The default is userid@domainname. The user ID of the job submitter is userid. The domain name where Infoprint Server is running is domainname.
  • mail-to-addresses: This attribute specifies the email addresses of the recipients of the email. One email address and one z/OS UNIX sendmail alias name are specified.
  • luname: This attribute specifies the NetSpool printer LU name.
  • lu-classes: This attribute assigns the NetSpool printer LU name to LU class 1.
  • default-owner: This attribute specifies the default Infoprint Server job owner for data sets that NetSpool spools for the associated logical unit (LU) if embedded job attributes in the print data do not specify an owner.
  • embedded-attributes-prefix: This attribute specifies, for data sets that NetSpool spools, the prefix that identifies job attributes embedded in the print data.
  • printway-formatting: This attribute specifies IP PrintWay use the FCB, if one is specified, to format line data.
  • print-page-header: This attribute causes IP PrintWay not to add a page header when it formats line data.
  • dataset-grouping: This attribute requests that data sets that are in the same JES output group be sent as attachments in the same email.
  • include-allocation: This attribute includes the previously defined Allocation component named printway. See Creating an allocation component.
Creating a PSF printer definition

This example creates a printer definition named prt2 for an AFP printer controlled by PSF:

pidu -c 'create printer prt2
         description = "Dept 002 printer"
         location = "Building 002 printer room"
         printer-type = psf-mvs
         destination = DEPT002
         output-class = J
         luname = LUPRT002
         lu-classes = { 2 }
         default-owner = smith
         embedded-attributes-prefix = "<<ibmjobattr"
         include-processing = afp_printer
         include-netspool-eof-rules = bracket ; '

Users can access this printer definition in these ways:

  • Local and remote users can use prt2 as the name of the destination, print queue, or printer definition.
  • IPP clients can use one of these URIs:
    • ipp://host/servlet/IPPServlet/prt2
    • http://host:631/servlet/IPPServlet/prt2
    The host name or IP address of the z/OS system is host.
  • JCL users can use the AOPPRINT procedure to access this printer definition, specifying prt2 as the printer name. For information about the AOPPRINT procedure, see z/OS Infoprint Server User’s Guide.
  • VTAM applications can use NetSpool printer LU name LUPRT002.

The attributes set in this printer definition are:

  • description: This attribute describes the printer definition.
  • location: This attribute describes the location of the printer.
  • printer-type: This attribute specifies that PSF manages the printer.
  • output-class: This attribute specifies the output class that is the JES work-selection criterion for the PSF printer FSA. In this example, the output class is J. NetSpool and Print Interface will allocate output data sets on the JES spool in class J.
  • luname: This attribute specifies the NetSpool printer LU name.
  • lu-classes: This attribute assigns the NetSpool printer LU name to LU class 2.
  • default-owner: This attribute specifies the default Infoprint Server job owner for data sets that NetSpool spools for the associated logical unit (LU) if embedded job attributes in the print data do not specify an owner.
  • embedded-attributes-prefix: This attribute specifies, for data sets that NetSpool spools, the prefix that identifies job attributes embedded in the print data.
  • include-object: These attributes include components in the printer definition. All attributes specified in the named components apply to this printer definition. The named components were created in previous examples.
Creating a general printer definition

This example creates a printer definition named fred for a printer that is not controlled by IP PrintWay or by PSF:

pidu -c 'create printer fred
         description = "Fred Jones"
         location = "Office A-11"
         printer-type = general
         general-spooling-mode = line
         destination = FRED ;'

Users can access this printer definition in these ways:

  • Local and remote users use fred as the name of the destination, print queue, or printer definition.
  • IPP clients use one of these URIs:
    • ipp://host/servlet/IPPServlet/fred
    • http://host:631/servlet/IPPServlet/fred
    The host name or IP address of the z/OS® system is host.
  • JCL users can use the AOPPRINT procedure to access this printer definition, specifying fred as the printer name. For information about the AOPPRINT procedure, see z/OS Infoprint Server User’s Guide.
    Tip:
    This example does not specify the luname attribute. Therefore, VTAM applications cannot print to this printer definition.

The attributes set in this printer definition are:

  • description: This attribute describes the printer definition.
  • location: This attribute describes the location of the printer.
  • printer-type: This attribute specifies General.
  • general-spooling-mode: This attribute tells Print Interface to write data to the output data set on the JES spool in record format.
  • destination: This attribute specifies the destination name that is the JES work-selection criterion for the printer. NetSpool and Print Interface allocate output data sets on the JES spool with destination name FRED.
Creating a printer pool definition

This example creates a printer pool definition named DEPT004. NetSpool creates a separate output data set on the JES spool for each printer definition in the printer pool definition.

To print to printer definitions p1, p2, and p3, VTAM applications use NetSpool printer LU name LU4.

pidu -c 'create printer-pool DEPT004
         description = "All printers in dept 004"
         luname = LU4
         lu-classes = { 1 2 }
         default-owner = smith
         embedded-attributes-prefix = "<<ibmjobattr"
         include-netspool-eof-rules = bracket
         printer-names = { p1 p2 p3 } ; '

The attributes set in this printer definition are:

  • description: This attribute describes the printer definition.
  • luname: This attribute specifies the NetSpool printer LU name LU4.
  • lu-classes: This attribute assigns the NetSpool printer LU to LU classes 1 and 2.
  • default-owner: This attribute specifies the default Infoprint Server job owner for data sets that NetSpool spools for the associated logical unit (LU) if embedded job attributes in the print data do not specify an owner.
  • embedded-attributes-prefix: This attribute specifies, for data sets that NetSpool spools, the prefix that identifies job attributes embedded in the print data.
  • include-netspool-eof-rules: This attribute includes the NetSpool End-of-File Rules component named bracket. You must also create this component.
  • printer-names: This attribute lists the names of the printer definitions in the pool. You must create printer definitions named p1, p2, and p3.
Creating an IP PrintWay FSS definition

This example creates an FSS definition for an IP PrintWay functional subsystem (FSS) named PRINTWAY. The name of this definition (PRINTWAY) must match the name used to define the FSS to JES. An IP PrintWay FSS definition is optional. Create one only if you want to change the default values that IP PrintWay uses.

pidu -c 'create printway-fss PRINTWAY
         trace-mode = internal ; '

The trace-mode attributes turns internal tracing on for the IP PrintWay FSS and all functional subsystem applications (FSAs) in this FSS.

Creating an IP PrintWay FSA definition

This example creates an FSA definition for an IP PrintWay functional subsystem application (FSA) named PRT123. The name of the FSA definition (PRT123) must match the name used to define the FSA to JES. An IP PrintWay FSA definition is optional. Create one only if you want to change default values that IP PrintWay uses.

pidu -c 'create fsa PRT123
         fsa-type = ip-printway
         trace-mode = full ; '

The attributes set in this printer definition are:

  • fsa-type: This attribute tells the ISPF panels to display this definition as an IP PrintWay FSA definition.
  • trace-mode: This attribute requests a full trace for this FSA.
Creating a PSF FSS definition

This example creates an FSS definition for a PSF functional subsystem (FSS) named PSFFSS. Your system programmer must also define an FSS named PSFFSS to JES.

pidu -c 'create psf-fss PSFFSS
         tcpip-job-name             = TCPIP ; '
Creating a PSF FSA definition

This example creates an FSA definition for a PSF functional subsystem application (FSA) named PRT3. Your system programmer must also define an FSA named PRT3 to JES.

pidu -c 'create fsa PRT3
         fsa-type = psf-tcpip
         form-definition = A10110
         location = "Bldg 3"
         operator-security-profile = "DENVER.001"
         page-definition = A08682
         printer-ip-address = 9.99.12.33 ; '

The attributes set in this printer definition are:

  • fsa-type: This attribute tells the ISPF panels to display this definition as a PSF FSA definition for a TCP/IP-connected printer.
  • form-definition: This attribute names the default form definition for the printer.
  • location: This attribute describes the location of the printer.
  • operator-security-profile: This attribute controls who can work with this printer using Infoprint Central.
  • page-definition: This attribute names the default page definition for the printer.
  • printer-ip-address: This attribute identifies the IP address of the target printer.
Creating a job selection rule

This example creates a job selection rule named Class-N. IP PrintWay extended mode uses the job selection rules to determine which print jobs to select from the JES spool for printing. You must create at least one job selection rule for IP PrintWay to select print jobs. You can create as many job selection rules as you need. The attributes of the print job must match all of the values in a rule to be selected.

 pidu -c 'create job-selection-rule Class-N
         job-selection-status = enabled
         output-class-list = {N}
         description = "Select overnight print jobs in Class N" ; '

The attributes set in this job selection rule are:

  • job-selection-status: This attribute specifies that IP PrintWay uses the job selection rule to determine which print jobs to select from the JES spool for printing.
  • output-class-list: This attribute specifies that IP PrintWay selects only print jobs in the specified JES output class.
  • description: This attribute describes the job selection rule.

Go to the previous page Go to the next page

Notices | Terms of use | Support | Contact z/OS | zFavorites



Copyright IBM Corporation 1990, 2014