getcmd
getcmd(command_buffer.i1a.r, status.i2.r [,buffer_length.i2.r])
This routine retrieves a command buffer queued to the task at the
TIME it was requested (by a call to the 'chgpgm' routine). The
command buffer is stored in the console common, CNSCOM, until it is
retrieved by a call to this routine. This routine must be called
during the initialization phase of application execution ('intype'
routine returns an interrupt type of INTINI) or this information
will be lost.
command_buffer user buffer to receive the command line
Command buffers that contain binary floating-point
values are to be preserved in the format
expected by the VMS version of applications.
Generaly, that will mean DEC format and that
Linux applications will need to convert
into IEEE.
status returned status of command buffer retrieval
(CLIB_OK -> successful transfer of command line,
CLIB_GETCMD_NOBUFFER -> no command line buffer
queued for this task)
[buffer_length] length of command line buffer to return. Defaults
to 80 bytes. Maximum length is CMD_LIN_SIZ.
(default is NULL)
This function requires the following include files:
cnsparam_h, clib_h, acnet_errors_h
Related functions:
chgpgm, acnet_chgpgm, putcmd, get_chgpgm_script, remote_program_check,
remote_program_get_script, remote_program_get_method, intype,
who_started_me
C/C++ usage:
char command_buffer[CMD_LIN_SIZ];
short error;
short buffer_length = CMD_LIN_SIZ;
getcmd(command_buffer,&error,&buffer_length);