Operation

To invoke ASOCTBL enter:

ASOCTBL

RUN ASOCTBL.PUB.SYS

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:

ASOCTBL

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:

> EXIT

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:

RUN ASOCTBL.PUB.SYS,LIST

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. For more information on the ASSOCIATE and DISASSOCIATE commands refer to MPE/iX Commands Reference Manual.