Display DLO Name (DSPDLONAM)

Where allowed to run: All environments (*ALL)
Threadsafe: No

The Display Document Library Object Name (DSPDLONAM) command is used to display or print alternate forms of a filed document, folder, or distribution document name.

Restrictions:

A user must have use (*USE) authority to the filed document or folder to display the various forms of the name.
Users must have all object (*ALLOBJ) special authority to display the various forms of the name for a distribution document.

Top

Parameters

Keyword	Description	Choices	Notes
DLO	Document library object	Character value, DOCID, LADNTSP, *SYSOBJNAM	Required, Positional 1
FLR	Folder	Character value, *NONE	Optional, Positional 2
DOCID	Document identifier	Character value, *NONE	Optional
LADNTSP	LADN timestamp	0000000000000001-FFFFFFFFFFFFFFFF, *NONE	Optional
SYSOBJNAM	System object name	Name, *NONE	Optional
OBJCLS	Object class	DOC, FLR, *DST	Optional
OUTPUT	Output	, PRINT	Optional

Top

Document library object (DLO)

Specifies the document or folder for which alternate names are to be displayed or printed.

This is a required parameter.

*DOCID: The document or folder is identified using its library-assigned document name specified in the DOCID parameter. The Folder (FLR) parameter must be *NONE.
*LADNTSP: The document or folder is identified using its library-assigned document name (LADN) timestamp specified in the LADNTSP parameter. The FLR parameter must be *NONE.
*SYSOBJNAM: The document or folder is identified using its system object name specified in the SYSOBJNAM parameter. The FLR parameter must be *NONE.
name: Specify the user-assigned name of the document or folder. The folder containing the specified document or folder is specified in the FLR parameter.

This is a required parameter.

Top

Folder (FLR)

Specifies the folder path that contains the document or folder specified in the Document library object (DLO) parameter. The FLR parameter must be *NONE if the DLO parameter is *DOCID, *LADNTSP, or *SYSOBJNAM.

*NONE: The document or folder is not contained in a folder, or is identified using the DOCID, LADNTSP, or SYSOBJNAM parameter.
name: Specify the name of the folder that contains the document or folder named in the DLO parameter.

Top

Document identifier (DOCID)

Specifies the library-assigned name of the document. This is the name assigned to the document by the system when it was created. Documents filed outside the local system have only library-assigned document names. The library-assigned document names can be determined by using the Query Document Library (QRYDOCLIB) command or by the message returned from the File Document (FILDOC) command.

Library-assigned document names are 24 characters in length with the following format:

YYYYMMDDHHMNSSHSSNSNSNSN

where:

       YYYY = year
         MM = month
         DD = day
         HH = hour
         MN = minute
         SS = second
         HS = hundredths of a second
   SNSNSNSN = system name

*NONE: A library-assigned document name is not specified for the object.
name: Specify the library-assigned name of the document or folder object. The library-assigned document name can be determined by using the Query Document Library (QRYDOCLIB) command or by the message returned from the File Document (FILDOC) or other command.

Top

LADN timestamp (LADNTSP)

Specifies the library assigned document name (LADN) timestamp of the document or folder object. A LADN timestamp is specified only if *LADNTSP is specified on the Document library object (DLO) parameter.

*NONE: A LADN timestamp is not specified for the object.
timestamp: Specify the LADN timestamp of the document library object.

Top

System object name (SYSOBJNAM)

Specifies the system object name of the document or folder object. A system object name is specified only if *SYSOBJNAM is specified on the Document library object (DLO) parameter.

*NONE: A system object name is not specified for the object.
name: Specify the system object name of the document library object.

Top

Object class (OBJCLS)

Specifies the class of the object to locate.

*DOC: The specified DLO is a filed document.
*FLR: The specified DLO is a folder.
*DST: The specified DLO is a distribution document.

Top

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*: Output requested by an interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output.

*PRINT: The output is printed with the job's spooled output.

Top

Examples

DSPDLONAM    DLO(MYDOC)  FLR(MYFLR)  OBJCLS(*DOC)

This command finds the document MYDOC in folder MYFLR and displays all forms of the document's name. If the job is running in batch mode, the information is printed and not displayed.

Top

Error messages

*ESCAPE Messages

CPF8AC0: &1 command failed.
CPF8AC1: Not authorized to distribution documents.
CPF8A75: Not authorized to access folder &1.
CPF8A77: Folder &1 not found.
CPF8A82: Document &2 not found in folder &1.
CPF8A83: Not authorized to access document &2 in folder &1.

Top