jbslistuser

Organization of this page

Function
Format
Required execution permission
Command directory
Arguments
Notes
Return values
Example

Function

The jbslistuser command lists the registered JP1 users.

Format

jbslistuser [-h logical-host-name]
            [-s authentication-server-name]
            [-ld]
            [-ds^#]

#:: The -ds option can be specified in Windows only.

To Page Top

Required execution permission

In Windows: Administrators (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)

In UNIX: Superuser or JP1/Base administrator permission

To Page Top

Command directory

In Windows:: installation-folder\bin\
In UNIX:: /opt/jp1base/bin/

To Page Top

Arguments

`-h` `logical-host-name`

When using JP1/Base in a cluster system, specify the logical host for which you want to execute this command. The command lists the JP1 users registered on the authentication servers set for this logical host.

`-s` `authentication-server-name`

Specify an authentication server to list the JP1 users registered on that authentication server. When you set this option, the -h option is ignored.

`-ld`

This option enables you to output the date and time at which user data was last modified for each user (yyyy/mm/dd HH:MM:SS format). The last modified date and time is updated when a JP1 user was registered or a password was changed. Note that the last modified date and time for JP1 users who were registered before upgrading to version 08-10, JP1 users who are initialized at the time of new installation, linkage users, and DS users is displayed by using hyphens (----/--/-- --:--:--). After a password is changed in the JP1/Base Environment Settings dialog box or by using the password change command (jbschgpasswd), the last modified data and time is displayed.

If you specify the -ds option, this option is ignored.

`-ds`

This option can be specified in Windows only.

If this option is specified, only a linkage user or DS user is displayed. JP1 user to be displayed will change depending on the setting of the ENABLE parameter in the directory server linkage definition file.

"ENABLE"=dword:00000001

Only linkage users among registered JP1 users are displayed.
"ENABLE"=dword:00000002

Only DS users among registered JP1 users are displayed.

Note that no JP1 user will be displayed if "ENABLE"=dword:00000000.

If this option is not specified, all the registered JP1 users will be displayed.

To Page Top

Notes

The -s option takes precedence if you specify both the -h and -s options. If you omit both options, the host name set in the environment variable JP1_HOSTNAME is assumed as the logical host. If you omit both options and nothing is set in JP1_HOSTNAME, the command lists the JP1 users registered on the authentication server(s) set for the physical host.
The -ds option takes precedence if both the -ld and the -ds options are specified.

To Page Top

Return values

`0`	Normal end
`1`	The user is not registered in the authentication server.
`2`	Invalid arguments
`4`	Insufficient system resource such as memory
`8`	The authentication server has not started or is not responding
`16`	An error occurred in the authentication server side processing
`32`	An error occurred while initializing the communication functionality.
`128`	Inconsistency in internal processing (a C++ exception)
`255`	Other error

To Page Top

Example

The following shows examples of output where the standard users jp1admin, jp1admin2 and the linked user or DS user testuser1 have been registered on the authentication server:

When no option is specified:

>jbslistuser 
jp1user account[0]:jp1admin
jp1user account[1]:jp1admin2
jp1user account[2]:testuser1
Successful.

When the -ld option is specified:

[Figure]

When the -ds option is specified:

>jbslistuser -ds
Collected Time:2017/05/31 11:20:00^#
jp1user account[0]:testuser1
Successful.

#: When the DS user output is displayed, the timestamp to indicate the time of collecting JP1 authentication information from the Active Directory is shown on the top line.

The following shows an example of output where the standard users jp1admin and jp1admin2 and no linked users or DS user have been registered on the authentication server:

When the -ds option is specified:

>jbslistuser -ds
Collected Time:2017/05/31 11:20:00
No jp1user account.
Failed.

To Page Top