Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001
Acquires a global resource identification number (RIN) and assigns a password to it.
GETRIN rinpassword
rinpassword Password of the intrinsic that locks the RIN. The password must contain from one to eight alphanumeric characters, beginning with an alphabetic character.
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 will reject your request and issue 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. This command may be issued from a session, job, program, or in BREAK. Pressing [Break] has no effect on this command.
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
Commands: None Manuals : Resource Management Programmer's Guide (32650-60011) Back to Main Index