This command loads a character variable with all or some of the HTTP response message header fields for a specified TCP connection.
OpenSTA will automatically wait until any request on the specified Connection ID is complete before executing this command. It is not necessary for the Script to do this explicitly.
If the data string is too long to fit into the target variable, it will be truncated.
The "WITH" clause can be used to specify the names of a header field whose value is to be retrieved from the HTTP response message. If this clause is omitted, all the response message header fields are retrieved.
The optional "RETURNING STATUS load_status" clause can be used to specify the integer variable to hold one of two values indicating whether the command succeeded or failed. There is an SCL include file "response_codes.inc" supplied with OpenSTA, which defines SCL integer constants for response status values. When "RETURNING STATUS" is specified, the "ON ERROR" action is disabled.
LOAD RESPONSE_INFO HEADER ON conid INTO variable {&}{,WITH identifier} {&}{,RETURNING STATUS load_status}
An integer variable, integer value or integer expression identifying the connection ID of the TCP connection on which the HTTP response message will be received.
The name of a character variable into which the HTTP response message headers, or the selected headers, are loaded.
A character variable, quoted character string or character expression containing the name of the response message header field to be retrieved.
An integer variable into which the status of the load response_info execution is loaded.
LOAD RESPONSE_INFO HEADER ON 4 INTO resp_headers