{
{   The purpose of this request is to provide the definition of a peripheral
{ element of the mainframe's active configuration.  A peripheral element is one
{ of the following types of elements:  channel adapter, communications element,
{ controller, storage device, or external processor.
{
{   The information provided describes the element and its connectivity to
{ other elements within the active configuration.  The information is derived
{ from the active physical configuration which has been installed in the
{ mainframe on which this request is issued.
{
{   For example, if the element were a tape controller, this request would
{ describe the identification of each channel (channel name, mainframe and IOU)
{ connected to the controller plus the names of tape storage device(s)
{ connected to the controller.
{
{   To use this request it is necessary to initialize the element_type field of
{ the element descriptor to one of the values identified in the case of the
{ peripheral_descriptor; however, it is not required that you know exactly
{ which type of peripheral you are querying.  The actual element_type is
{ returned in the DEFINITION parameter.
{
{       CMP$GET_ELEMENT_DEFINITION (ELEMENT, DEFINITION, STATUS)
{
{ ELEMENT: (input)  This parameter specifies the identity of the peripheral
{       element whose definition is desired.  The identity may be specified
{       using either the name of the element or its hardware address.
{
{       If a hardware address is specified you must initialize the
{       physical_address_specifier to indicate how many parts of the address
{       are initialized in the address path.  For example, if you are querying
{       a unit, the physical_address_specifier must include a channel, a
{       channel_address and the unit_address and you must initialize all three
{       fields of the hardware address.
{
{       If a hardware address is specified and the mainframe has more than one
{       IOU, the name of the IOU must be initialized because the channel
{       identification is ambiguous in this case.  The IOU component of the
{       peripheral descriptor will be ignored on single IOU mainframes.
{
{ DEFINITION: (output)  This parameter describes the element and its connect-
{       ivity with other elements in the mainframe's active configuration.
{
{ STATUS: (output) This parameter specifies the request status.
{
{         CONDITIONS:
{                     cme$lcm_element_not_found,
{                     cme$lcm_empty_pa_set,
{                     cme$lcm_missing_pa_set_member,
{                     cme$lcm_not_available,
{                     cme$lcm_ring_validation_error,
{                     cme$privileged_job_required.
{
{         IDENTIFIER : 'CM'
{
