local_request_queue – Create and remove the CICS local request queue

Synopsis

  • Create and remove the local request queue data set used by a CICS® region. The local request queue data set stores pending BTS requests. It ensures that, if CICS fails, no pending requests are lost.

  • You can use this module when provisioning or de-provisioning a CICS region.

  • Use the state option to specify the intended state for the local request queue. For example, state=initial will create a local request queue data set if it doesn’t yet exist, or it will take an existing local request queue and empty it of all records.

Parameters

region_data_sets

The location of the region data sets to be created using a template, for example, REGIONS.ABCD0001.<< data_set_name >>.

If you want to use a data set that already exists, ensure that the data set is a local request queue data set.

required: True
type: dict
dfhlrq

Overrides the templated location for the local request queue data set.

required: False
type: dict
dsn

The data set name of the local request queue to override the template.

required: False
type: str
template

The base location of the region data sets with a template.

required: False
type: str
space_primary

The size of the primary space allocated to the local request queue data set. Note that this is just the value; the unit is specified with space_type.

This option takes effect when the local request queue data set is being created. If the data set already exists, the option has no effect.

required: False
type: int
default: 4
space_secondary

The size of the secondary space allocated to the local request queue data set. Note that this is just the value; the unit is specified with space_type.

This option takes effect when the local request queue data set is being created. If the data set already exists, the option has no effect.

required: False
type: int
default: 1
space_type

The unit portion of the local request queue data set size. Note that this is just the unit; the value is specified with space_primary.

This option takes effect only when the local request queue data set is being created. If the data set already exists, the option has no effect.

The size can be specified in megabytes (M), kilobytes (K), records (REC), cylinders (CYL), or tracks (TRK).

required: False
type: str
default: M
choices: M, K, REC, CYL, TRK
state

The intended state for the local request queue, which the module will aim to achieve.

absent will remove the local request queue data set entirely, if it already exists.

initial will create the local request queue data set if it does not already exist, and empty it of all existing records.

warm will retain an existing local request queue data set in its current state.

required: True
type: str
choices: initial, absent, warm

Examples

- name: Initialize a local request queue data set
  ibm.ibm_zos_cics.local_request_queue:
    region_data_sets:
      template: "REGIONS.ABCD0001.<< data_set_name >>"
    state: "initial"

- name: Initialize a large request queue data set
  ibm.ibm_zos_cics.local_request_queue:
    region_data_sets:
      template: "REGIONS.ABCD0001.<< data_set_name >>"
    space_primary: 50
    space_type: "M"
    state: "initial"

- name: Delete a local request queue data set
  ibm.ibm_zos_cics.local_request_queue:
    region_data_sets:
      template: "REGIONS.ABCD0001.<< data_set_name >>"
    state: "absent"

Return Values

changed
True if the state was changed, otherwise False.
returned: always
type: bool
failed
True if the Ansible task failed, otherwise False.
returned: always
type: bool
start_state
The state of the local request queue data set before the Ansible task runs.
returned: always
type: dict
data_set_organization
The organization of the data set at the start of the Ansible task.
returned: always
type: str
sample: VSAM
exists
True if the local request queue data set exists.
returned: always
type: bool
end_state
The state of the local request queue data set at the end of the Ansible task.
returned: always
type: dict
data_set_organization
The organization of the data set at the end of the Ansible task.
returned: always
type: str
sample: VSAM
exists
True if the local request queue data set exists.
returned: always
type: bool
executions
A list of program executions performed during the Ansible task.
returned: always
type: list
name
A human-readable name for the program execution.
returned: always
type: str
rc
The return code for the program execution.
returned: always
type: int
stdout
The standard out stream returned by the program execution.
returned: always
type: str
stderr
The standard error stream returned from the program execution.
returned: always
type: str