LJK/Security Reference Manual


Previous Contents Index


MANUAL_EXAMINATION_UNANSWERED

Accept unanswered manual examination information for report formatting.

Format

MANUAL_EXAMINATION_UNANSWERED

POLICY_NUMBER, POLICY_NAME, GROUP_NAME, ASSIGNED_NODE_NAME, ASSIGNED_USER_NAME


RETURNS

VMS usage: boolean
type: byte (unsigned)
access: write only
mechanism: by value

Arguments

POLICY_NUMBER


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

Number that can be used as an index into an array of policies used in the assessment whose results are being reported.

POLICY_NAME


VMS usage: char_string
type: character string (maximum length 39)
access: read only
mechanism: by descriptor

Name of the LJK/Security policy for which this Group is unanswered.

GROUP_NAME


VMS usage: char_string
type: character string
access: read only
mechanism: by descriptor

Name of the Manual Examination group under which this question is classified.

ASSIGNED_NODE_NAME


VMS usage: char_string
type: character string (maximum length 39)
access: read only
mechanism: by descriptor

Node name on which the Manual Examination question has not been answered.

ASSIGNED_USER_NAME


VMS usage: char_string
type: character string
access: read only
mechanism: by descriptor

Username by whom the Manual Examination question has not been answered.

Description

This entrypoint provides details regarding groups of unanswered Manual Examination questions, including who is responsible for answering them.

A Boolean value returned by this entrypoint indicates whether processing of this report should continue. A value of FALSE will terminate processing.


NODE_DETAIL

Accept detailed node information for report formatting.

Format

NODE_DETAIL

POLICY_NUMBER, POLICY_NAME, NODE_NAME, LATEST_STATUS, ERROR_STATUS, LATEST_TIME, SUBMITTED_TIME, DUE_TIME, POLICY_TIME, TRANSMITTED_TIME, RESULTS_TIME, STOPPED_TIME, CANCELLED_TIME, COMPLETED_TIME, SUBMITTED_USERNAME, STOPPED_USERNAME, CANCELLED_USERNAME, REQUESTING_NODE, REQUESTED_POLICY, REQUEST_MEDIUM, RESULT_MEDIUM, LICENSE_NUMBER, TRIBUTARY_VMS_VERSION, TRIBUTARY_LJK_VERSION, ERROR_TEXT


RETURNS

VMS usage: boolean
type: byte (unsigned)
access: write only
mechanism: by value

Arguments

POLICY_NUMBER


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

Number that can be used as an index into an array of policies used in the assessment whose results are being reported.

POLICY_NAME


VMS usage: char_string
type: character string (maximum length 39)
access: read only
mechanism: by descriptor

Name of the LJK/Security policy against which this node was assessed.

NODE_NAME


VMS usage: char_string
type: character string (maximum length 39)
access: read only
mechanism: by descriptor

Name of the node to which these details apply.

LATEST_STATUS


VMS usage: char_string
type: character string (maximum length 11)
access: read only
mechanism: by descriptor

Status of the assessment on the named node.

ERROR_STATUS


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

VMS status for the completion of the assessment on the subject node. See also ERROR_TEXT.

LATEST_TIME


VMS usage: date_time_type
type: quadword (unsigned)
access: read only
mechanism: by reference

Time of the last change in status for this node.

SUBMITTED_TIME


VMS usage: date_time_type
type: quadword (unsigned)
access: read only
mechanism: by reference

Time the assessment was submitted for this node. (Valid only if the LATEST_STATUS at some point has been "SUBMITTED".)

DUE_TIME


VMS usage: date_time_type
type: quadword (unsigned)
access: read only
mechanism: by reference

Time the running of the assessment for this node is due. (Valid only if the LATEST_STATUS at some point has been "DUE".)

POLICY_TIME


VMS usage: date_time_type
type: quadword (unsigned)
access: read only
mechanism: by reference

Time the policy for this node was modified.

TRANSMITTED_TIME


VMS usage: date_time_type
type: quadword (unsigned)
access: read only
mechanism: by reference

Time the assessment request was transmitted to this Node. (Valid only if the LATEST_STATUS at some point has been "TRANSMITTED".)

RESULTS_TIME


VMS usage: date_time_type
type: quadword (unsigned)
access: read only
mechanism: by reference

Time results were obtained from this node.

STOPPED_TIME


VMS usage: date_time_type
type: quadword (unsigned)
access: read only
mechanism: by reference

Time this assessment was stopped for this node. (Valid only if the LATEST_STATUS at some point has been "STOPPED".)

CANCELLED_TIME


VMS usage: date_time_type
type: quadword (unsigned)
access: read only
mechanism: by reference

Time this assessment was cancelled for this node. (Valid only if the LATEST_STATUS at some point has been "CANCELLED".)

COMPLETED_TIME


VMS usage: date_time_type
type: quadword (unsigned)
access: read only
mechanism: by reference

Time this assessment was completed for this node. (Valid only if the LATEST_STATUS at some point has been "COMPLETED".)

SUBMITTED_USERNAME


VMS usage: char_string
type: character string
access: read only
mechanism: by descriptor

Name of the user who submitted the assessment.

STOPPED_USERNAME


VMS usage: char_string
type: character string
access: read only
mechanism: by descriptor

Name of the user who stopped the assessment.

CANCELLED_USERNAME


VMS usage: char_string
type: character string
access: read only
mechanism: by descriptor

Name of the user who cancelled the assessment.

REQUESTING_NODE


VMS usage: char_string
type: character string (maximum length 39)
access: read only
mechanism: by descriptor

Node from which the assessment was requested.

REQUESTED_POLICY


VMS usage: char_string
type: character string (maximum length 39)
access: read only
mechanism: by descriptor

Policy requested for this Node.

REQUEST_MEDIUM


VMS usage: char_string
type: character string
access: read only
mechanism: by descriptor

Medium for transmission of the assessment request.

RESULT_MEDIUM


VMS usage: char_string
type: character string
access: read only
mechanism: by descriptor

Medium for transmission of the assessment results.

LICENSE_NUMBER


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

LJK/Security license number.

TRIBUTARY_VMS_VERSION


VMS usage: char_string
type: character string
access: read only
mechanism: by descriptor

LJK/Security version on the tributary node.

TRIBUTARY_LJK_VERSION


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

LJK/Security version number.

ERROR_TEXT


VMS usage: char_string
type: character string (maximum length 512)
access: read only
mechanism: by descriptor

A text rendition of the longword error code in ERROR_STATUS, including arguments in certain cases.

Description

This entrypoint provides detailed information regarding the testing status for various nodes in the assessment.

A Boolean value returned by this entrypoint indicates whether processing of this report should continue. A value of FALSE will terminate processing.


NODE_TOTAL

Accept total node information for report formatting.

Format

NODE_TOTAL

INTERVAL_TIME, NEXT_TIME, TOTAL_NODES, COMPLETED_NODES, SUBMITTED_NODES, DUE_NODES, TRANSMITTED_NODES, WAITANSWERS_NODES, RESULTS_NODES, STOPPED_NODES, CANCELLED_NODES, TOTAL_POLICIES


RETURNS

VMS usage: boolean
type: byte (unsigned)
access: write only
mechanism: by value

Arguments

INTERVAL_TIME


VMS usage: date_time_type
type: quadword (unsigned)
access: read only
mechanism: by reference

Time between repeating assessments of this node.

NEXT_TIME


VMS usage: date_time_type
type: quadword (unsigned)
access: read only
mechanism: by reference

Time for the next repeating assessment of this node.

TOTAL_NODES


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

Number of nodes addressed by this assessment.

COMPLETED_NODES


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

Number of nodes whose status is COMPLETED.

SUBMITTED_NODES


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

Number of nodes whose status is SUBMITTED.

DUE_NODES


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

Number of nodes whose status is DUE.

TRANSMITTED_NODES


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

Number of nodes whose status is TRANSMITTED.

WAITANSWERS_NODES


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

Number of nodes whose status is WAITANSWERS.

RESULTS_NODES


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

Number of nodes whose status is RESULTS.

STOPPED_NODES


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

Number of nodes whose status is STOPPED.

CANCELLED_NODES


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

Number of nodes whose status is CANCELLED.

TOTAL_POLICIES


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

Number of distinct policies.

Description

This entrypoint provides information regarding total numbers of nodes for which processing of this assessment is in various states (e.g., Completed, Submitted, Cancelled, etc.).

A Boolean value returned by this entrypoint indicates whether processing of this report should continue. A value of FALSE will terminate processing.


POLICY_RULE_TEXT

Accept policy rule text for report formatting.

Format

POLICY_RULE_TEXT

NUMBER_OF_POLICIES, POLICY_NUMBER, POLICY_NAME, RULE_CODE, RULE_NAME


RETURNS

VMS usage: boolean
type: byte (unsigned)
access: write only
mechanism: by value

Arguments

NUMBER_OF_POLICIES


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

Largest value which the POLICY_NUMBER value will reach on subsequent calls.

POLICY_NUMBER


VMS usage: longword_unsigned
type: unsigned longword
access: read only
mechanism: by reference

Number that can be used as an index into an array of policies used in the assessment whose results are being reported.

POLICY_NAME


VMS usage: char_string
type: character string (maximum length 39)
access: read only
mechanism: by descriptor

Name of the LJK/Security policy for which these terms are applicable.

RULE_CODE


VMS usage: char_string
type: character string (maximum length 80)
access: read only
mechanism: by descriptor

Second exemption parameter for exemption (DISK, REPORT, RULE) in the subject policy.

RULE_NAME


VMS usage: char_string
type: character string (maximum length 511)
access: read only
mechanism: by descriptor

Text value for exemption (DISK, REPORT, RULE) in the subject policy.

Description

This entrypoint provides your Report Formatting module with a series of terms for the rules embodied in the test discipline for the policies used in an assessment. Examples include:

Table 9-3 Example Rules
  Rules
Discipline Rule Code Rule Name
NIST 800-53 SI-7 Software and Information Integrity
PCI DSS 8 Assign a unique ID to each person with computer access

Those terms needed by your Report Formatting module should be stored away by your POLICY_RULE_TEXT entrypoint for use during calls to your other entrypoints.

Keep in mind that LJK/Security will call your POLICY_RULE_TEXT entrypoint once for each rule in each policy used in a given assessment, which will mean multiple calls. Storage of the strings provided to your POLICY_RULE_TEXT entrypoint should be indexed according to the POLICY_NUMBER parameter provided to the call.


Previous Next Contents Index