Acquires a global resource identification number (RIN) and
assigns a password to it.
Operation Notes |
 |
The GETRIN
command acquires a global RIN from the MPE/iX RIN pool, typically
during a session. You must assign an arbitrary password for the
RIN, which aids in restricting its use to authorized users. You
can then give this RIN and the associated password to cooperating
users so that it can be locked and unlocked by them. For instructions
on how to lock and unlock a RIN, and how to pass a RIN and its password
as intrinsic parameters, refer to the MPE/iX Intrinsics
Reference Manual (32650-90028).
Users who know the RIN and its password can use it in their
programs (in jobs or sessions) until the user who acquired the RIN
releases it with the FREERIN
command. The RIN acquired is always a unique, positive integer.
The total number of RINs MPE/iX can allocate is specified when the
system is configured, but cannot exceed 1024. If all currently available
RINs have been acquired by other users, MPE/iX rejects your request
and issues the message:
In this case, you must wait until one of the RINs becomes
available, or request that your system manager raise the maximum
number of RINs that can be assigned.
Use |
 |
This command may be issued from a session, job, program, or
in BREAK. Pressing Break has
no effect on this command.
Example |
 |
To acquire a global RIN and assign to it the password MYRIN,
enter:
MPE/iX responds with the RIN number assigned, for example: