Filter
Top Products
Chapter 4 277
Command Definition F-K
GETRIN
GETRIN
Acquires a global resource identification number (RIN) and assigns a password to it.
Syntax
GETRIN rinpassword
Parameters
rinpassword Password of the intrinsic that locks the RIN. The password must contain
from one to eight alphanumeric characters, beginning with an alphabetic
character.
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:
RIN TABLE FULL
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:
GETRIN MYRIN
MPE/iX responds with the RIN number assigned, for example:
RIN: 1