The Print Directory Information (PRTDIRINF) command is used to print directory information for objects in the Integrated File System that was collected by the Retrieve Directory Information (RTVDIRINF) command. A spooled file with file name QPEZDIR goes to the spool queue associated with the job using this command.

Restrictions:

• You must have all object (*ALLOBJ) special authority to run this command.
• Job CCSID value 65535 is not allowed.

Parameters

Keyword	Description	Choices	Notes
RPTTYPE	Type of report	*DIR, *OBJ, *OWN	Required, Positional 1
INFFILEPFX	Information file prefix	Simple name, *LAST	Optional
INFLIB	Information library	Name, *LAST	Optional
OWNER	Owners	Generic name, name, *ALL	Optional
OBJ	Objects	Path name, *ALL, *NONE	Optional
OBJTYPE	Object types	Single values: *ALL Other values (up to 60 repetitions): *ALRTBL, *AUTL, *BLKSF, *BNDDIR, *CFGL, *CHTFMT, *CHRSF, *CLD, *CLS, *CMD, *CNNL, *COSD, *CRG, *CRQD, *CSI, *CSPMAP, *CSPTBL, *CTLD, *DDIR, *DEVD, *DIR, *DOC, *DSTMF, *DTAARA, *DTADCT, *DTAQ, *EDTD, *EXITRG, *FCT, *FIFO, *FILE, *FLR, *FNTRSC, *FNTTBL, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCSRT, *IGCTBL, *IMGCLG, *IPXD, *JOBD, *JOBQ, *JOBSCD, *JRN, *JRNRCV, *LIB, *LIND, *LOCALE, *MBR, *MEDDFN, *MENU, *MGTCOL, *MODD, *MODULE, *MSGF, *MSGQ, *M36, *M36CFG, *NODGRP, *NODL, *NTBD, *NWID, *NWSD, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *SBSD, *SCHIDX, *SOCKET, *SPADCT, *SQLPKG, *SQLUDT, *SRVPGM, *SSND, *STMF, *SVRSTG, *SYMLNK, *S36, *TBL, *TIMZON, *USRIDX, *USRPRF, *USRQ, *USRSPC, *VLDL, *WSCST	Optional
SUBTREE	Directory subtree	*ALL, *NONE	Optional
MINSIZE	Smallest size	0-99999, 0	Optional
SORT	Sort by	*SIZE, *OWNER, *LSTCHG, *NAME	Optional
INCPATH	Include path names	*ALL, *NONE	Optional

Top

Type of report (RPTTYPE)

Specifies the type of report to print.

This is a required parameter.

*DIR

A report of space being used by each directory is printed. Information will include a total size for the outermost directory and all nested subdirectories. Information for each subdirectory will include the total of space for just the subdirectory and will not include space for objects in any directories contained in the subdirectory.

*OBJ

A report of object information for files and directories is printed.

*OWN

A report of the user profile (owner) information for files and directories is printed.

Information file prefix (INFFILEPFX)

Specifies the file name prefix of the database files that were created by the Retrieve Directory Information (RTVDIRINF) command to store the retrieved directory information.

*LAST

The database files created by the most recent invocation of the RTVDIRINF command will be used. Informational message CPI1E31 will be sent to the job log and will contain the name and library of the files used.

information-file-prefix

Specify the same file prefix as was specified on a previous invocation of the RTVDIRINF command. The RTVDIRINF command created multiple database files to store the retrieved directory information. If a file prefix is specified, a value other than *LAST must be specified for the INFLIB parameter.

Information library (INFLIB)

Specifies the library that contains the database files that were created by the Retrieve Directory Information (RTVDIRINF) command to store the retrieved directory information.

*LAST

The library used by the most recent invocation of the RTVDIRINF command will be used to find the database files which contain the retrieved directory information. Informational message CPI1E31 will be sent to the job log and will contain the name and library of the files used.

library-name

Specify the name of the library that contains the database files created by a previous invocation of the RTVDIRINF command. If a library name is specified, a value other than *LAST must be specified for the INFFILEPFX parameter.

Owners (OWNER)

Specify the names of the owners (user profiles) of the objects to print information about.

*ALL

The report contains information about objects owned by any user profile.

owner-name

Specify the user profile that owns the objects to print information about.

generic-name

Specify the generic user profile that owns the objects to print information about. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk (*) substitutes for any valid characters. A generic name specifies all user profiles with names that begin with the generic prefix.

Objects (OBJ)

Specifies the names of the objects to print information about.

*ALL

If you specify an owner (OWNER parameter), all objects owned by the specified owner are included. If OWNER(*ALL) is specified, all objects are included in the report.

*NONE

No detail object information is included in the report, just a total size of owned objects, if *NONE is specified for Object (OBJ) parameter and *OWN is specified for the Type of report (RPTTYPE) parameter.

object-name

The object information is included only for the objects specified by the given name. If an owner is specified (OWNER parameter), only the objects meeting the owner criteria and that match the given name are included.

generic-name

The object information is included only for the objects that match the specified generic name. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk (*) substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix. If an owner is specified (OWNER parameter), only the objects meeting the owner criteria and that match the given generic name are included.

Object types (OBJTYPE)

Specifies the object types to print information about. If the OWNER or OBJ parameters were specified with a value other than *ALL, the owner and object name criteria must also be met.

Single values

*ALL

Information about objects of all types is printed.

Other values (up to 60 repetitions)

object-type

Information about objects of the type(s) specified is printed.

Directory subtree (SUBTREE)

Whether to print subdirectories statistics in the report or not.

*ALL

Statistics are included for all subdirectories within the directory processed by the Retrieve Directory Information (RTVDIRINF) command.

*NONE

Statistics are included only for objects in the directory processed by the Retrieve Directory Information (RTVDIRINF) command.

Smallest size (MINSIZE)

Specifies the size of the smallest object to include.

0

All objects are included regardless of size.

size

Specify size in number of kilobytes.

Sort by (SORT)

Specifies the order in which the information should be sorted.

*SIZE

Information is sorted by object size, from largest to smallest.

*OWNER

The information is sorted in alphabetical order by owner name.

*LSTCHG

The information is sorted by last-change date with the oldest information first.

*NAME

Information is sorted by object name, names are listed in alphabetical order.

Include path names (INCPATH)

Specifies if the report will include the path where the objects reside. If *NONE is specified for Object (OBJ) parameter and *OWN is specified for the Type of report (RPTTYPE) parameter, this parameter will be ignored.

*ALL

Paths are included in the report.

*NONE

Paths are not included in the report.

Examples

Example 1: Print Information, Grouped by Owner, for Most Recent RTVDIRINF

PRTDIRINF   RPTTYPE(*OWN)  INFFILEPFX(*LAST)  INFLIB(*LAST)
            OWNER(*ALL) OBJ(*ALL) OBJTYPE(*ALL)  SORT(*SIZE)

This command prints an owner report from the database file created by the most recent invocation of the Retrieve Directory Information (RTVDIRINF) command. Information in the report will be included for all objects, grouped by their owner. The information is sorted by object size and sent to the printer file QPEZDIR.

Example 2: Print a Directory Report

PRTDIRINF   RPTTYPE(*DIR)  INFFILEPFX(MYROOTDIR)
            INFLIB(QUSRSYS)  SUBTREE(*ALL)

This command prints a directory report from database file MYROOTDIRO and MYROOTDIRD created by a prior invocation of the Retrieve Directory Information (RTVDIRINF) command. If information was collected for subdirectories by the RTVDIRINF command, that information will be included in the directory report. The information is sent to the printer file QPEZDIR.

Error messages

*ESCAPE Messages

CPF2110

Library &1 not found.

CPF1ED2

File &1 is in use and cannot be accessed.

CPF1ED5

File prefix &1 or library &2 not found in QAEZDBFILE.

CPF1ED6

File &1 in library &2 not found.

CPF1ED9

Retrieved directory information not complete.

CPF1EEC

Not authorized to file &1.

CPF1E99

Unexpected error occurred.