Operation [ MPE/iX System Utilities Reference Manual ] MPE/iX 5.0 Documentation
MPE/iX System Utilities Reference Manual
Operation
To invoke ASOCTBL enter:
ASOCTBL
or
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 (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).
MPE/iX 5.0 Documentation