To add a login definition to TRS:
exec sgw_addlog login, pwd, HOST_LOGIN, HOST_PWD, tran_group, con_group, gwctrl
where:
login is the login ID of the user, sent from the client application. For example, this would be the value provided in the -U flag specified in isql. Length: maximum of 30 characters.
pwd is the login password.
HOST_LOGIN is the login ID by which this user is known to the mainframe. Leave this field blank only if you are also not specifying a HOST_PWD. The value for this field must be in uppercase. Length: maximum of 8 characters.
HOST_PWD is the password for the HOST_LOGIN. The value for this field must be in uppercase. Leave this field blank only if you are also not specifying a HOST_LOGIN. Length: maximum of 8 characters.
tran_group is the name of the collection of RPCs this user can access. This collection must be defined to TRS, and a user can be assigned to only one transaction group (see “Adding a connection group”). Length: maximum of 8 characters.
con_ group (LU 6.2 only) is the name of the collection of connections this user can access. This connection group must be defined to TRS, and a user can be assigned only one connection group. (See “Adding a connection group”.)
For TCP/IP only, include a comma or null as a placeholder, but do not provide a value for the con_group parameter. Length: maximum of 8 characters.
gwctrl is the TRS administration procedures permission indicator. Choose one of these values:
yes grants the user permission to access and make changes using control, configuration, and security procedures.
no means the user has status-querying permission only.
If you type something other than yes or no,
the gwctl parameter defaults to no.
To add the user named “BERTHA” to an LU 6.2 TRS:
exec sgw_addlog bertha, BIGBLUE, BIG, BLEUBRT, TGROUP1, FINANCE, yes
go
This isql example adds a TRS user named “BERTHA” with a password of “BIGBLUE,” and a host login and password of “BIG” and “BLEUBRT,” respectively. “BERTHA” can use RPCs defined to the transaction group named “TGROUP1” and connections included in the connection group named “FINANCE.” “BERTHA” has permission to administer TRS.