pidu command

You can use the z/OS® UNIX pidu command to run the Printer Inventory Definition Utility (PIDU).

Format

pidu [-qv] [-c "command; …"]… [filename]… 

Description

The pidu command lets you specify one or more of the PIDU commands to manage objects in the Printer Inventory. You can specify PIDU commands in the -c option or in a file. The pidu command writes a report of errors to standard error (stderr) and writes informational messages and command output to standard output (stdout).

Options

-c "command; …"
Specifies one or more PIDU commands. Enclose the commands in single or double quotation marks, and end each statement with a semicolon. If a command contains a value that requires single quotation marks, such as a hexadecimal value, enclose the commands in double quotation marks. You can repeat the -c option.

If you do not specify the -c option or the name of a file, pidu reads the commands from standard input (stdin), which can be either keyboard data or output from another command.

You can specify these PIDU commands:
  • create
  • delete
  • display
  • dump
  • export
  • force-create
  • list
  • modify
  • rename
-q
Suppresses informational messages that the pidu command writes to stdout.
-v
Writes the name of the Printer Inventory to stderr. Also provides more informational messages.

Operands

filename
The name of a UNIX file or sequential MVS™ data set that contains the commands. You can repeat this option.
If the data set is an MVS data set, specify // before the file name. If you specify a fully qualified data set name, also enclose the data set name in single quotation marks and specify a backslash before each single quotation mark. For example, if the output file is named USERID.MYFILE, enter:
//\'USERID.MYFILE\'
If you want your TSO user ID prefixed to the data set name, specify:
//MYFILE

To specify commands from stdin, omit the file name and the -c option.

Usage notes

  • You can specify PIDU commands interactively from your keyboard.
  • When you specify PIDU commands in a UNIX file (such as a z/FS file) or an MVS data set, you can:
    • Start comments with a number sign (#).
    • Include blank lines, if wanted.
    • Specify the PIDU command names, attribute names, and attribute values on separate lines:
      • In a UNIX file, an attribute value can span lines if all lines other than the last line end with a backslash. Be sure that no blank characters are present after the backslash. For example:
        attribute1 = 
        'A very, very, very long \
        value'
      • In an MVS data set, the entire attribute value must be on one line. To specify a long attribute value, allocate a data set that has a logical record length of 255 (LRECL=255) and a variable blocked record format (RECFM=VB). Then, specify the entire value on one line. For example:
        attribute1 = 
        'A very, very, very long value'

Examples -- pidu

Entering PIDU commands interactively

To enter one or more PIDU commands interactively from your keyboard:
  1. On the z/OS UNIX command line, type pidu and press Enter.
  2. Type a PIDU command and press Enter. For example, to create an FSA definition, type:
    create fsa PRT001 fsa-type = psf-tcpip form-definition = A10110
    page-definition = A08682 printer-ip-address = 9.99.12.33;
  3. After the command is processed, type another command and press Enter. For example, to display the attributes of the FSA definition that you just created, enter:
    display fsa PRT001;
  4. After the command is processed, use Ctrl-D or type exit to end the pidu command.

Specifying PIDU commands on the command line

To specify two PIDU list commands with the -c option, enter:

pidu -c "list fsa; list psf-fss;"

Specifying PIDU commands in a file

To specify a UNIX file that is named pidu.commands and that contains PIDU commands, enter:

pidu pidu.commands
To use the < symbol to redirect stdin to file pidu.commands, enter:
pidu <pidu.commands
To specify a fully qualified MVS data set named MARY.PIDU.CMDS, enter:
pidu //\'MARY.PIDU.CMDS\'
To prefix your TSO user ID to the data set name, enter:
pidu //PIDU.CMDS

File pidu.commands (or data set PIDU.CMDS) contains the PIDU commands. For example:

create fsa PRT001 fsa-type = psf-tcpip form-definition = A10110
 page-definition = A08682 printer-ip-address = 9.99.12.33;
 list fsa;  # list all FSAs

Environment variables

AOPCONF
Names the Infoprint Server configuration file. The file that is named in this variable takes precedence over the user-specific configuration file ($HOME/.aopconf) and the system default configuration file (/etc/Printsrv/aopd.conf).
LIBPATH
The path that is used to locate dynamic link libraries (DLL).
NLSPATH
Lists the directory where the Infoprint Server message catalogs are located.
PATH
Lists the directory where the Infoprint Server executable files are located.

Files

$HOME/.aopconf
Contains the user-specific Infoprint Server configuration file. This file takes precedence over /etc/Printsrv/aopd.conf.
/etc/Printsrv/aopd.conf
The default Infoprint Server configuration file.

Exit values

0
The PIDU commands were done successfully.
>0
An error occurred that prevented one or more PIDU commands from being done successfully.