The Get Terminal Data routine accesses TERMTABLE.EXE and returns the character sequence that causes a terminal to perform a specified operation. Format SMG$GET_TERM_DATA termtable-address ,request-code ,maximum-buffer-length ,return-length ,capability-data [,input-argument-vector]
1 – Returns
OpenVMS usage:cond_value type: longword (unsigned) access: write only mechanism: by value
2 – Arguments
termtable-address OpenVMS usage:address type: longword (unsigned) access: read only mechanism: by reference Specifies the address of the TERMTABLE entry for the desired terminal. The termtable-address argument is the address of an unsigned longword that contains the address of the terminal capabilities table (TERMTABLE). The TERMTABLE address is returned by SMG$INIT_TERM_TABLE or SMG$INIT_TERM_TABLE_BY_TYPE. request-code OpenVMS usage:longword_signed type: longword (signed) access: read only mechanism: by reference Longword constant of the form SMG$K_code, where code is the name of the desired capability field. The request-code argument is the address of a signed longword that contains the request code. The SMG$K_code constants can be found in the library supplied by OpenVMS, $SMGTRMPTR. maximum-buffer-length OpenVMS usage:longword_signed type: longword (signed) access: read only mechanism: by reference Maximum length of the buffer into which the requested capability data is written. The maximum-buffer-length argument is the address of a signed longword that contains the maximum number of bytes that can be written into the buffer. return-length OpenVMS usage:longword_signed type: longword (signed) access: write only mechanism: by reference Receives the number of bytes actually written into the buffer. The return-length argument is the address of a signed longword into which is written the number of bytes transferred into the buffer. capability-data OpenVMS usage:unspecified type: unspecified access: by reference, array reference mechanism: 0 Address of the first byte of the buffer which is to receive the capability data. The capability-data argument contains the address of the buffer. input-argument-vector OpenVMS usage:vector_longword_unsigned type: longword (unsigned) access: read only mechanism: by reference, array reference Address of a list of longwords used for capabilities that require a variable number of arguments, and for those that require substitution or arithmetic operations on an argument. The input- argument-vector argument is the address of an array of unsigned longwords that contains capability arguments. The first longword must contain the number of arguments that follow.