To invoke ASOCTBL enter:
or
The system responds with a > prompt and you should enter the following:
>devclass=username.acctname
|
Parameters
- devclass
The name of a logical device class configured with
SYSGEN or NMMGR. When you specify a device class, all devices
assigned to that class are affected by the ASSOCIATE command.
- username
The name assigned to the user by the Account Manager. It must contain from one to eight alphanumeric characters, beginning with an alphabetic character. The username parameter may be replaced by @ to indicate all users. For example, @.acctname enables all users in the specified account.
- acctname
The name created by the System Manager to identify the account. It must contain from one to eight alphanumeric characters, beginning with an alphabetic character. The acctname parameter may be replaced by @ to indicate all accounts. For example, username.@ enables all users of the specified name in any account.
- @.@
Enables all users in all accounts.
ASOCTBL expects input from an ASCII file or a terminal.
If data is read from a file, the formal file designator is INPUT.
ASOCTBL reads the input file until it finds an end-of-file (EOF)
indicator or a statement beginning with EXIT in column 1.
When ASOCTBL finds errors in the INPUT file, it scans
remaining data and then terminates without updating ASOCIATE.PUB.SYS.
If a file equation for INPUT does not exist, ASOCTBL prompts for
input from the terminal.
You may not use a text editor to directly modify the ASOCIATE file.
Using ASOCTBL with an ASCII File |
 |
To run ASOCTBL with an ASCII file you must first create the file
using a text editor such as EDIT3000. For example, in the following
ASCII file the users and accounts, MGR.MNFG, USER.UTILTY and JACK.MR
KTG will be able to associate with LP, TAPE and LP2 respectively.
EDITOR
/ADD
1 LP = MGR.MNFG
2 TAPE = USER.UTILTY
3 LP2 = JACK.MRKTG
4 EXIT
5 //
/KEEP ASOTFILE,UNN
/E
|
Once you have created the file and named it, you must use it in a file
equation and then invoke the file. To continue the preceding example,
you would enter:
FILE INPUT=ASOTFILE
ASOCTBL
|
ASOCTBL displays the devices and the users specified in the ASCII file
ASOTFILE.
Using ASOCTBL Interactively |
 |
To use ASOCTBL interactively enter:
At the ASOCTBL prompt, enter devices and the user names you want
to associate. For example:
> LP = MGR.MNFG
> TAPE = USER.UTILTY
> LP2 = JACK.MRKTG
|
To terminate ASOCTBL, enter:
Using Wildcards in User and Account Names |
 |
You may use wildcards to specify an association for a group of users, such
as those using the same account.
For example, the command below associates all users logged onto the
FINANCE account, and the user JACK logged onto any account
with the device class LP:
ASOCTBL
> LP = @.FINANCE,JACK.@
> EXIT
|
In this example user JACK.MRKTG, all users logged onto the FINANCE account, and the user JACK logged onto any account may associate with device class LP.
Removing Entries from ASOCIATE.PUB.SYS |
 |
ASOCTBL builds a new version of ASOCIATE.PUB.SYS each time it is invoked and successfully terminates. Therefore, to remove entries invoke ASOCTBL and specify only the the entries you currently want.
Listing the Association Table |
 |
To list the association table in ASOCIATE.PUB.SYS (users and the devices to which they may associate) enter:
Fatal Errors |
 |
The following error messages indicate a condition where no modifications are made to the association table. Although you may continue to make inputs to the system without damage, you should exit from ASOCTBL and begin again.
UNABLE TO DELETE OLD 'ASOCIATE.PUB.SYS' FILE
EXPECTED AT LEAST 3 PARAMETERS, LDEV = USER.ACCT
= MUST FOLLOW LDEV
UNABLE TO OPEN INPUT FILE
CLASS NAMES ARE LIMITED TO 8 CHARACTERS
NO SUCH CLASS IN THIS SYSTEM
EXPECTED . FOLLOWING USER NAME
UNABLE TO OPEN NEW ASOCIATE.PUB.SYS FILE
EXPECTED , FOLLOWING EACH USER.ACCT
USER AND ACCOUNT NAMES ARE
1 TO 8 ALPHANUMERIC CHARACTERS
OR "@".
|
Additional Discussion |
 |
For more information refer to Controlling System Activity (32650-90155). For more information on the ASSOCIATE and DISASSOCIATE commands refer to MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-90003 and 32650-90364).