|
|
|
|
The ANAME database contains all of the names that are available on the ANAME network.
The location of the database is identified in the anamed.ini file.
Users can create and delete entries associated with their local LU.
The administrator for ANAME can manage entries for any user.
The four fields that are contained in a record in the database are as follows:
Specify this value when you register with ANAME. Your user name should be an easy-to-remember, unique nickname for the fully qualified LU name that identifies you to others in the ANAME network.
The fully qualified LU name associated with this particular record. SNAP-IX
takes this from the name of the local LU that you are using with the
ANAME application. This is normally the default LU associated
with the local node (the control point LU), unless you have set the
Optionally, specify this value when you register with ANAME. There are no restrictions on the number of instances of the same group name or on the number of users registered as members of one group. Several users can register with the same group name. Typically, all members of a department or team register as part of a particular group.
Optionally, specify this value when you register with ANAME. This field identifies the TPs associated with a fully qualified LU name. There are no restrictions on the number of instances of the same TP name or the number of users registered with one TP name.
Commands for ANAME functions can be entered in either uppercase or lowercase. For example, to register a user name, you can use either the REG or reg command.
Names registered with ANAME should be values that are easy to remember and will not change over time. When selecting names to register with ANAME, consider how the names will be used as the ANAME network grows and changes. Follow these rules and conventions:
Use names that will remain unique within a specific domain. For example, avoid using first names and initials.
Use defined and understood domains as group names, such as team or department names.
Use names that are easily associated with the person or entity using the name, such as local area networks (LANs) or host IDs.
Choose names that can be used for a variety of purposes throughout APPC. For example, because APPC partner aliases must be eight characters or less in length, an ANAME user name that is also used as an alias should meet this size limitation.
It is not necessary to enter information in all four fields when adding a record. What you enter depends on your situation.
User name
The simplest way to register a user name in the ANAME database is to associate a name you select with a fully qualified LU name. To do so, enter the following:
aname REG -u UserName
A record is created in the database associating the UserName with the fully qualified LU name from which the command was issued. The UserName must be unique to the fully qualified LU name.
Group name or names
If you belong to any group or groups in the ANAME network, add the group names to the database so that others on the network can find you. (You can use the same user name if you are using the same fully qualified LU name.) For example, if you belong to a team and to a department, you can register both by entering the following:
aname REG -u UserName -g TeamName
aname REG -u UserName -g DepartmentName
Transaction program names
If you want other users on the ANAME network to know what transaction programs are installed on your computer, you can register the program names in the database. For example, to register the ATELLD program in the database and associate it with your fully qualified LU name, enter the following command:
aname REG -t ATELLD
Because it is possible to have more than one user name for each fully qualified LU name, you can make the association more specific by adding a user name to the command:
aname REG -u UserName -t ATELLD
For more information, see Summary of Supported ANAME Commands.
The ANAME application must be able to locate the ANAMED target program to access the name-to-PLU mapping (to locate the PLU). You can accomplish this in one of two ways:
Specify the option on the command line when adding a record (see Options and Parameters Used with ANAME Commands) to locate the target program (ANAMED).
Create a side information record to locate the target program (ANAMED).
For example, if the ANAMED target program was on the LU called MYLU on the network called MYNETWORK, the following creates an appropriate side information record:
snaadmin define_cpic_side_info, sym_dest_name=ANAMED, partner_lu_name=MYNETWORK.MYLU, tp_name=ANAMED
Valid characters for all fields in ANAME include uppercase and lowercase A-Z, the numbers 0-9, and the special characters listed in Additional Valid Characters for All Fields in ANAME.
Several non-alphanumeric characters have restrictions, as follows:
The hyphen (-) cannot be used as the first character of any field value.
The asterisk (*) and question mark ( ?) characters cannot be used in field values. They are reserved as special characters for search routines. (See Wildcards.)
The period (.) character cannot be used as a value in group names or user names.
The delete function enables you to remove a record or records from the ANAME database. Records are removed only if the fully qualified LU name in the record matches the LU that you are currently using with the source program. For example, to delete all the records with the specified user name and the source program's current fully qualified LU name, enter:
aname DEL -u UserName
To delete a record with a specified user name and group name, enter:
aname DEL -u UserName -g GroupName
For more information, see Summary of Supported ANAME Commands.
You can use the query function to view a single record or multiple records in the ANAME database.
For example, to view the record of a group called TechDept, enter:
aname QRY -g TechDept
To view all the records for a particular user name, enter:
aname QRY -u UserName
To view all the records that match a specific user name and group name, enter:
aname QRY -u UserName -g GroupName
To view all the records that match a specific group name and TP name, enter:
aname QRY -g GroupName -t TPName
If you specify only one field, the program returns entries that match on this field and have no other fields set, in preference to entries that match on this field and also have other fields set. For example, if you specify only the user name, and there are records for the specified user name both with and without a group name specified, this command returns only the records that have no group name specified.
If you specify a TP name, the program returns entries that contain this TP name, and also entries that have no TP name specified.
When searching the database for a specific value, only TP names are case sensitive. Matches for the other three fields are found by alphabetic value only.
To view multiple records that contain a common field value, use wildcard
searches. (For more information about wildcards, see Wildcards.)
For example, to view all the records for user names that begin with the letter
A
, enter:
aname QRY -u "A*"
For more information, see Summary of Supported ANAME Commands.
To obtain help on how to use all ANAME commands, enter one of the following commands:
aname ?
aname -h
aname -help
To obtain help on a specific command, include the function name in the command. For example, to get help for the Register function, enter one of the following commands:
aname REG ?
aname REG -h
aname REG -help
For more information, see Summary of Supported ANAME Commands.
A System Administrator can duplicate a UserName that is already registered by entering the following command:
aname reg -d -u UserName
This command can be used to associate an existing user name with resources on local systems and those resources on remote systems. This enables a remote user to request any of the resources on the local node by using a single user name. The ANAMED target program then determines which LU handles requests for the resource.
Because some Solaris shells do wildcard expansion on the command line, it is important to remember to put quotation marks (") around wildcard commands. The following set of wildcards is recognized by ANAME:
Use the asterisk (*) to view or delete all records in a particular field. For example, "*" indicates all user names.
Use the asterisk (*) following a value to indicate
that you want to view or delete all the values that contain the characters
you specify. For example, "J*" indicates
all the values that begin with the letter J
.
Use the question mark (?) to indicate a placeholder.
A question mark between characters causes a search on the specified characters
and any unspecified character that falls in between. For example, "J??n" would match values such as John
, Jean
, and Joan
.
Supported ANAME Commands, summarizes the commands that enable you to control the ANAME database. Use each command with at least one of the flags shown in Options and Parameters Used with ANAME Commands.
You can enter the following commands in uppercase or lowercase:
Options and Parameters Used with ANAME Commands, summarizes the options and parameters that you can use with the ANAME commands.
|
|
|
 |
|