modify—change attributes of an object

Format

Description

The modify command modifies attributes for an object in the Printer Inventory. The object must already exist in the Printer Inventory.

Changes you make to attributes for a printer definition or component generally take effect for the next data set that NetSpool and Print Interface allocate on the JES spool and the next data set that IP PrintWay™ selects from the JES spool. Changes to NetSpool end-of-file rules or to the NetSpool LU class (attribute lu-classes), however, are related to the VTAM® session and do not take effect for the next data set allocated on the JES spool. For information about when changes to these fields take effect, see Specifying how NetSpool determines end-of-file and Grouping NetSpool printer LUs into LU classes.

Changes you make to a printer definition or component do not affect data sets that IP PrintWay has retained on the JES spool after successful or failed transmission.

Changes you make to attributes for an FSA definition take effect only when you restart the IP PrintWay or PSF FSA. Changes you make to attributes for an FSS definition take effect when you restart the FSS.

You can modify attributes in the system configuration definition only if dynamic configuration is enabled. With a few exceptions, the new and changed attributes in the system configuration definition take effect when you run the PIDU command. If you change certain attributes, however, you must stop and restart the daemons that use the attribute before the change can take effect.

Operands

objectclass

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

name

The name of the object. Names are case-sensitive, so be sure to use the correct uppercase and lowercase letters. Enclose the name in single or double quotation marks if the name contains special characters.

Tip: To modify 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

• To remove an attribute, type null as the value for the attribute. For a description of the null value, see Default values.
• If you modify an attribute in a component, the modified attribute applies to all printer definitions that include the component unless the attribute is also specified for the printer definition itself. In this case, the printer definition retains its attribute value.
• If you repeat the same attribute in a modify statement, the PIDU program uses the last specification.
• You can use the list command with the modify command to modify all or selected objects in an object class. For an example, see Listing and modifying printer definitions.

Examples -- modify

Modifying an allocation component

This example modifies the Allocation component named printway. The modified attribute (output-class) applies to all printer definitions that include this component unless the output-class attribute is specified for the printer definition itself.

pidu -c 'modify allocation printway output-class=L ; '    

Modifying a printer definition

This example changes the protocol used by IP PrintWay in the printer definition named lab_printer. (For the create statement for this printer definition, see Creating an IP PrintWay printer definition for a PCL printer with IPP protocol.)

pidu -c 'modify printer lab_printer
         protocol-type              = lpr
         printer-uri                = null
         printer-ip-address         = printer2.boulder
         print-queue-name           = TEXT ; '

The attributes modified in this printer definition are:

• protocol-type: The new protocol is the LPR protocol.
• printer-uri: This attribute is removed because the URI is not used for the LPR protocol.
• printer-ip-address: This attribute specifies the host name of the remote printer. It is required for the LPR protocol.
• print-queue-name: This attribute specifies the print queue name on the remote printer. It is required for the LPR protocol.

Modifying the system configuration definition

This example specifies the name of a log stream defined to the MVS™ system logger in the system configuration definition, which is named aopd.conf:

pidu -c 'modify configuration aopd.conf logstream-name = AOP.MSG ; '

Listing and modifying printer definitions

This example, entered as one command on the z/OS UNIX command line, lists selected printer definitions and changes an attribute in those printer definitions. This example uses these PIDU commands and the awk command:

1. The PIDU list command lists the names of all printer definitions with output-class=K.
2. These names are input to the awk program, which writes PIDU modify commands to modify the output-class attribute. For information about the awk program, see z/OS UNIX System Services Command Reference.
3. The output from the awk program is input to the pidu command:

pidu -qc "list printer where output-class = K ; " |
     awk '{ print "modify printer " $1 " output-class = \"B\";" }' |
     pidu