Using the GSSM Command
GSSM extends the capabilities of SSM to allow you to create and update multiple network, user, and security profiles at the same time, based on a new or existing item. The list of profiles to create or update can be provided by (all or part of) an active SELECT list, or the list can be created on the fly. GSSM uses the existing SSM screens for NETWORK, USERS, and SECURITY to modify an existing source item or create a new one.
Syntax
GSSM {?} item ([N ‖ U ‖ S] {A}{C}{M}
Syntax elements
? Shows the usage details.
item The item-id of a source item to be used as the basis for creating or updating profiles. This can be an existing item in the NETWORK, USERS, or SECURITY file (as appropriate), or it can be created on the fly by the C option. There are restrictions on the existing items than can be used as source items.
N Applies to network profiles in the NETWORK file. When using an existing profile, the Location Description and CCI fields cannot be modified.
The following NETWORK items are reserved cannot be used as the source item: DEFAULT.
U Applies to user profiles in the USERS file. When using an existing profile, the Description and Password fields cannot be modified.
The following USER items are reserved cannot be used as the source item: DEFAULT, DSPMON, FILEDSP, NETDSP, REMFS, RLTYXDSP, SQLDEMO, SYSMAN and TAPEDSP.
S Applies to security profiles in the SECURITY file.
The following SECURITY items are reserved cannot be used as the source item: DEFAULT, DEFAULT.EXPLORER, DEFAULT.HARNESS, DEFAULT.REALWEB, DEFAULT.WEBSERVICE, REMFS, SYSMAN, SYSMAN.EXPLORER and TL.SECURITY.
A Adds any items from the select list that do not already exist in the relevant file. If this option is absent, only items in the select list that already exist in the file are updated.
C Allows the creation of a new source item if it does not already exist in the relevant file.
M Allows modification of the active select list of items, or creation of a new select list if one is not active (see list maintenance details below). The command validates that each item already exists in the relevant file before adding it to the list, unless the A option is also being used.
Restriction
Can only be run from the SYSMAN account.
Comments
One of the options N, U, or S must be specified.
Newly-created items based on the source item will use their id as the description rather than the source item's description.
If no changes are made to an existing source item using either EX or FI, the items in the active select list will not be changed and will report "No changes made."
If the existing source item is deleted using FD or a new item is abandoned using EX, the items in the active select list will not be changed and will report "'<itemid>' has been deleted."
List maintenance
The M option allows the entries in an active selection list to be modified or, if no list is active, create a new list of items.
The initial display (for example with items from an active select list) may appear as follows. This example assumes that GSSM (UM has been used so the selection list is interpreted as a list of user names.
GSSM Maintain list of USERS item ids ---------------------------------------------------------------------------- ---------------------------------------------------------------------------- Page 1 of 1 1. MICHAELSMITH 2. HELENJONES 3. VIJITAPATEL Option: 'P'rev Page, 'N'ext Page, 'F'irst Page, 'L'ast Page, 'S'ort Items, 'H'elp '*' add all items in file, 'A'dd items, 'D'elete items, 'C'ompleted, 'Q'uit
Each option on this screen is accessed by a single keystroke; the available commands are explained when the H (Help) key is pressed.
GSSM
Maintain list of USERS item ids
---------------------------------------------------------------------------------
---------------------------------------------------------------------------------
'S'ort items Sort the list into alphabetical order (after confirmation)
and redisplay the list starting at the first page.
'F'irst page Display the first page of the list if not already displayed.
'N'ext page Display the next page of the list if not at the last page.
'P'revious page Display the previous page if not at the first page.
'L'ast page Display the last page if not already at the last page.
'*' Add items from the file that are not already in the list.
'Q'uit Abandon this list (after confirmation).
'C'ompleted The maintenance of this list is complete (after confirmation).
'A'dd items Add items to the end of list until a null item is entered.
'D'elete items Delete items from the list until a null item is entered.
'V'alidation Toggle checking that the entries exist in the file
before adding to the list.
'CR' To return.
Examples
Example 1
To modify and create user profiles based on a new SUPERVISOR user, with an active select list containing the item-ids MICHAELSMITH, HELENJONES and VIJITAPATEL but where only MICHAELSMITH currently exists in the USERS file:
3 Items selected. >GSSM SUPERVISOR (UCA
At this point the SSM USERS FILE MAINTENANCE screen appears (because of the U option) so that you can create the SUPERVISOR item (because of the C option).
U S E R S F I L E M A I N T E N A N C E -------------------------------------------------------------------------------- User ID >SUPERVISOR *NEW ITEM* 0 Description : 1 Password (Pwd) :None 13 Status :D 2 Pwd Expiration Date :None 14 Type :I 3 Pwd Validity Period :0 15 Messages :Yes 4 No of prior pwds :0 16 Language :0 5 Allowed Paths :None 17 Remote Systems:None 6 Disallowed Paths :None 18 Next Logon Pwd:None 7 Default Account Name :None 19 On Pwd expiry :None 8 Default Logon Proc :None 20 Ret. Locks :None 9 Logon Retries :5 21 Update Locks :None 10 Log Failed Attempts :No 22 Verb file path:No 11 PLIDs :None 23 Environment :No 12 Profile IDs :None 24 Pwd definition:No Enter option# (0-24) to change; EX to exit; FI to file; FD to delete :
When you enter FI to file this new item, GSSM resumes by asking you to confirm that you want to create and update the items identified in the select list, based on SUPERVISOR.
Apply changes to supplied list of items (Y/N) Y
'MICHAELSMITH' has been updated.
'HELENJONES' has been added.
'VIJITAPATEL' has been added.
Because of the A option, MICHAELSMITH is updated and HELENJONES and VIJITAPATEL are added.
Example 2
To modify existing network profiles based on another existing entry PLID000, where the list of entries to maintain will be entered manually. This is useful to create a list where it is difficult to generate an active select list.
: GSSM PLID000 (NM
At this point the Maintain List of NETWORK Item IDs screen appears (because of the M option) so that you can identify the PLIds to be updated.
GSSM Maintain list of NETWORK item ids ---------------------------------------------------------------------------- ---------------------------------------------------------------------------- Page 1 of 1 1. PLID001 2. PLID002 3. PLID003 Option: 'P'rev Page, 'N'ext Page, 'F'irst Page, 'L'ast Page, 'S'ort Items, 'H'elp '*' add all items in file, 'A'dd items, 'D'elete items, 'C'ompleted, 'Q'uit
When you enter C to complete the list, the SSM NETWORK FILE MAINTENANCE screen appears, so that you can modify PLID000 as required, to act as the source item.
N E T W O R K F I L E M A I N T E N A N C E -------------------------------------------------------------------------------- PLId ID >PLID000 0 Location Description :Unknown 1 CCI : 13 Type Ahead :YES 2 Logon Timeout :20 14 Expedited Logon :No 3 Logon Retries :0 15 Split Basic Debugger :No 4 Log Failed Attempts :No 5 Hushed Logon :No 6 Immediate Disconnect :No 7 Passworded User Logon :No 8 Terminal Type :6 9 Inactivity Timeout :0 10 Receipt of Messages :Yes 11 Messages on Line 25 :Yes 12 Field Read :0 Enter option# (0-15) to change; EX to exit; FI to file; FD to delete :
When you enter FI to file this modified item, GSSM resumes by asking you to confirm that you want to update the items identified in the list, based on PLID000.
Apply changes to supplied list of items (Y/N) Y 'PLID001' has been updated. 'PLID002' has been updated. 'PLID003' has been updated.