Display DLO Name (DSPDLONAM)
Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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 | 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.
- 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 |