Display Service Tools User ID (DSPSSTUSR)
| Where allowed to run: All environments (*ALL) Threadsafe: Yes |
Parameters Examples Error messages |
The Display Service Tools User ID (DSPSSTUSR) command shows a list of service tools user identifiers. It can also be used to show detailed information about a specific service tools user ID, including the status and privileges of that user.
When printing the output, the detailed usage information about each service tools user ID will be included in the output.
If a new file is created when sending the output to a physical file, system file QASYDSPDST in system library QSYS with a format name of QSYDSDST is used as a model.
Restrictions: To use this command, you must have either security administrator (*SECADM) or audit (*AUDIT) special authorities.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| USRID | Service tools user ID | Character value, *ALL | Optional, Positional 1 |
| OUTPUT | Output | *, *PRINT, *OUTFILE | Optional |
| OUTFILE | File to receive output | Qualified object name | Optional |
| Qualifier 1: File to receive output | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| OUTMBR | Output member options | Element list | Optional |
| Element 1: Member to receive output | Name, *FIRST | ||
| Element 2: Replace or add records | *REPLACE, *ADD |
| Top |
Service tools user ID (USRID)
Specifies the service tools user ID for which the information is to be shown.
- *ALL
- All service tools user IDs are shown.
- name
- Specify the name of the service tools user ID to be shown.
| Top |
Output (OUTPUT)
Specifies where the output from the command is sent.
- *
- The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
- The output is printed with the job's spooled output.
- *OUTFILE
- The output is directed to the database file specified for the File to receive output (OUTFILE) parameter.
| Top |
File to receive output (OUTFILE)
Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.
Qualifier 1: File to receive output
- name
- Specify the name of the database file to which the command output is directed.
Qualifier 2: Library
- *LIBL
- The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.
- *CURLIB
- The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.
- name
- Specify the name of the library to be searched.
| Top |
Output member options (OUTMBR)
Specifies the name of the database file member that receives the output of the command.
Element 1: Member to receive output
- *FIRST
- The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the File to receive output (OUTFILE) parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
- name
- Specify the name of the file member that receives the output. If it does not exist, the system creates it.
Element 2: Replace or add records
- *REPLACE
- The system clears the existing member and adds the new records.
- *ADD
- The system adds the new records to the end of the existing records.
| Top |
Examples
Example 1: Displaying Basic Information
DSPSSTUSR USRID(11111111)
This command shows the status and privileges of the service tools user ID named 11111111. Because OUTPUT(*) is assumed, the information is either displayed or printed, depending on where the command is submitted.
Example 2: Printing All Service Tools User Identities
DSPSSTUSR USRID(*ALL) OUTPUT(*PRINT)
This command causes the status and privileges of all service tools user identities to be printed.
| Top |
Error messages
*ESCAPE Messages
- CPF4AA8
- Service tools user ID &1 not found.
- CPF9860
- Error occurred during output file processing.
- CPFB304
- User does not have required special authorities.
| Top |