HPlogo MPE/iX System Utilities Reference Manual > Chapter 3 ASOCTBL

ASOCTBL Operation

MPE documents

Complete PDF
Table of Contents
Index

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.



Chapter 3 ASOCTBL

Chapter 4 BULDACCT