Administration Commands
query_focal_point
YES
The user_name parameter identifies a group name. Any user in this group will use this emulator user record unless there is an explicit record for the user’s user name.
NO
The user_name parameter identifies a user name.
If the command requested information about user sessions, a 3270_session_data or 5250_session_data subrecord is returned for each session. For more information about these subrecords, see Section 2.22, define_emulator_user.
2.131.4 Error Return Codes
If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Parameter Check
If the command does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
PARAMETER_CHECK
secondary_rc
Possible values are:
INVALID_EMULATOR_USER
The list_options parameter was set to LIST_INCLUSIVE, but the user_name parameter did not match the name of any defined user.
State Check
No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Other Conditions
Appendix A, Common Return Codes from snapadmin Commands, lists combinations of primary and secondary return codes that are common to all commands.
2.132 query_focal_point
The query_focal_point command returns information about the focal point for a specific Management Services category or about multiple focal points, depending on the options used.
2.132.1 Supplied Parameters
Parameter name | Type | Length | Default |
[query_focal_point] |
|
|
|
num_entries | decimal |
| 1 |
list_options | constant |
| LIST_INCLUSIVE |
ms_category | character | 8 | (null string) |
Supplied parameters are:
387
