Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

System Functions (n - p) PUT_CONTROL(2)
The following considerations apply to use on magnetic tapes:
When device is not ready
If a magnetic tape rewind is performed concurrently with application program
execution (that is, a rewind operation other than 6), any attempt to perform a
read, write, or control operation to the rewinding tape unit while rewind is taking
place results in an error indication. A subsequent call to the FILE_GETINFO_
or FILEINFO procedure shows that an error 100 occurred.
Wait for rewind to complete
If a magnetic tape rewind operation of 6 (wait for completion) is performed as a
nowait operation, the application waits at the call to the AWAITIO procedure for
the rewind to complete.
The following considerations apply to use for interprocess communication:
Nonstandard operation and param values
You can specify any value for the operation and param parameters. An
application-defined protocol should be established for interpreting nonstandard
parameter values.
Process not accepting system messages
If the object of the control operation is not accepting process CONTROL mes-
sages, the call to PUT_CONTROL() completes but a subsequent call to the
FILE_GETINFO_ or FILEINFO procedure shows that an error 7 occurred.
Process control You can obtain the process identifier of the caller to PUT_CONTROL() in a
subsequent call to the FILE_GETRECEIVEINFO_ (or LASTRECEIVE or
RECEIVEINFO) procedure.
To use this function on systems running H06.21 or later RVUs or J06.10 or later RVUs, you must
perform all of the following tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library (/G/system/zdllnnn/zputdll).
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
this function with 32-bit or 64-bit applications.
To use this function in a 32-bit application on systems running H06.24 or later RVUs or J06.13 or
later RVUs, perform the same tasks (described above) used to enable the function on systems
running H06.21/J06.10 or later RVUs.
To use this function in a 64-bit application on systems running H06.24 or later RVUs or J06.13 or
later RVUs, you must perform all of the following tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Compile the application using the -Wlp64 compiler command option.
527186-023 Hewlett-Packard Company 5−191