W2AP - Web2.0 DFHATOMPARMS container

      CONTROL BLOCK NAME = DFHW2APC
      DESCRIPTIVE NAME = CICS TS (W2) DFHATOMPARMS container
           Licensed Materials - Property of IBM
            Restricted Materials of IBM 
           5655-Y04
           (C) Copyright IBM Corp. 2008 
      FUNCTION = Mapping of DFHATOMPARMS container passed to
                 resource-dependent Atom service routines.
      NOTES :
       DEPENDENCIES = z/Arch
       RESTRICTIONS =
       MODULE TYPE = Control block definition
     ------------------------------------------------------------------
       DFHATOMPARMS container
       This copybook contains a mapping of fields in the DFHATOMPARMS
       container, which is intended to be used at the parameter list
       for the resource-dependent service routine called by the
       Atomservice feed manager.
       ATMP_OPTIONS
         Address of a double word containing 64 option bits.
         The first word is used to send options to the service routine,
         and the second word is used to receive options from the
         service routine.
       ATMP_RESPONSE
         Address of a double word in which the response and reason
         code can be returned. These are both initialized to zero,
         indicating successful completion.
       ATMP_RESNAME
         Address of a double word containing a pointer to the CICS
         resource name, followed by its length.
       ATMP_RESTYPE
         Address of a double word containing a pointer to the CICS
         resource type name in uppercase, followed by its length.
         The type can be PROGRAM, FILE, or TSQUEUE.
       ATMP_ATOMTYPE
         Address of a double word containing a pointer to the type of
         Atom document being processed, in lowercase, followed by its
         length. The value of the type string is either "entry" or
         "feed".
       ATMP_ATOMID
         Address of a triple word containing the address of a buffer
         containing Atom request identifier from the atom:id element,
         followed by its length, followed by the total length of the
         containing buffer. When handling a POST request, you can use
         this buffer to return a new atom id to represent the newly
         constructed resource.
       ATMP_HTTPMETH
         Address of a double word containing a pointer to the HTTP
         method padded with spaces, followed by its length.
         It is one of GET, POST, PUT or DELETE.
       ATMP_TAG_AUTHORITY
         Address of a double word containing a pointer to a URI
         authority name, followed by its length. The authority name
         is a host name or email address that can be can be used by
         the service routine to construct tag scheme URIs as described
         in RFC4151.
       ATMP_TAG_DATE
         Address of a double word containing a pointer to a date
         associated with ATMP_TAG_AUTHORITY, followed by its length.
         The date is in ISO8601 format (YYYY-MM-DD) and is a date at
         which this system is permitted to use the authority named
         in ATMP_TAG_AUTHORITY for minting tag scheme URIs.
       ATMP_XMLTRANSFORM
         Address of a double word containing a pointer to the name
         of an XMLTRANSFORM resource, followed by its length. The
         XMLTRANSFORM resource describes the layout of records within
         the CICS resource being externalized in the feed. If the
         length of this name is zero, it indicates that no bindfile
         was specified for the resource, and the service routine must
         perform its own mapping.
       ATMP_ROOT_ELEMENT
         Address of a double word containing a pointer to the name
         of the root element of the XML structure being mapped by the
         XMLTRANSFORM resource, followed by its length.
       ATMP_MTYPEIN
         Address of a double word containing a pointer to the
          mediatype of the incoming HTTP request body, if any,
         followed by its length. It is only meaningful if the HTTP
         method is POST or PUT, otherwise the pointer and length are
         both zero.
       ATMP_MTYPEOUT
         Address of a double word containing a pointer to an area in
         which the routine must return the mediatype of the data being
         returned in the DFHATOMCONTENT container, followed by the
         length of that area (56 bytes). On entry to the service
         routine, this area contains the requested content type:
         "text", "html", "xhtml", or a mediatype such as "text/xml",
         that can be used to control the format of document returned.
       ATMP_PUBLISHED
         Address of a double word containing a pointer to an area in
         which the routine must return the date and time at which the
         returned document was first published, followed by the length
         of that area (32 bytes). The value must be returned in
         xs:dateTime format, which is the same as RFC3339 format,
         (namely yyyy-mm-ddThh:mm:ss.fffZ) or as spaces.
         The .fff fractional seconds are optional, and may be omitted.
         If spaces are returned, the current time is assumed.
       ATMP_UPDATED
         Address of a double word containing a pointer to an area in
         which the routine must return the date and time at which the
         returned document was last updated, followed by the length of
         that area (32 bytes). The value must be returned in
         xs:dateTime format, which is the same as RFC3339 format,
         (namely yyyy-mm-ddThh:mm:ss.fffZ) or as spaces.
         The .fff fractional seconds are optional, and may be omitted.
         If spaces are returned, the current time is assumed.
       ATMP_EDITED
         Address of a double word containing a pointer to an area in
         which the routine must return the date and time at which the
         returned document was last edited, followed by the length of
         that area (32 bytes). The value must be returned in
         xs:dateTime format, which is the same as RFC3339 format,
         (namely yyyy-mm-ddThh:mm:ss.fffZ) or as spaces.
         The .fff fractional seconds are optional, and may be omitted.
         If spaces are returned, the current time is assumed.
       ATMP_ETAGVAL
         Address of a double word containing a pointer to the Etag
         value for the selected record, followed by its length.
         The Etag (or entity tag) is any string that can be used to
         identify the record instance uniquely.
       ATMP_WINSIZE
         Address of a double word containing a pointer to the feed
         window size, followed by its length. The value is a numeric
         string that contains the default number of entries to be
         returned in each feed.
       ATMP_SELECTOR
         Address of a double word containing a pointer to the selector
         value from the URL, followed by its length. This parameter is
         used to select the record in the CICS resource that is to be
         accessed.
       ATMP_NEXTSEL
         Address of a double word into which the service routine
         should set a pointer and length of a selector value for the
         next record in the resource, if any.
       ATMP_PREVSEL
         Address of a double word into which the service routine
         should set a pointer and length of a selector value for the
         previous record in the resource, if any.
       ATMP_FIRSTSEL
         Address of a double word into which the service routine
         should set a pointer and length of a selector value for the
         first (newest) record in the resource, if any.
       ATMP_LASTSEL
         Address of a double word into which the service routine
         should set a pointer and length of a selector value for the
         last (oldest) record in the resource, if any.
       ATMP_ID_FLD
         Address of a double word containing a pointer to the name of
         the field within the resource that contains the atom
         identifier from the atom:id element, if present, followed by
         its length. If it is present, the service routine should use
         this named field to store the contents of the atom:id element
  .
       ATMP_PUBLISHED_FLD
         Address of a double word containing a pointer to the name of
         the field within the resource that contains the time when the
         resource was first published, if present, followed by its
         length. If no such field exists, the pointer and length are
         both zero. If it is present, the service routine should use
         this named field to locate the value of the timestamp that
         can be used to construct the value returned in the
         ATMP_PUBLISHED parameter. This parameter may be all spaces
         if the resource does not contain such a field.
       ATMP_UPDATED_FLD
         Address of a double word containing a pointer to the name of
         the field within the resource that contains the time when the
         resource was last updated, if present, followed by its length.
         If no such field exists, the pointer and length are both zero.
         If it is present, the service routine should use this named
         field to locate the value of the timestamp that can be used
         to construct the value returned in the ATMP_UPDATED parameter.
         This parameter may be all spaces if the resource does not
         contain such a field.
       ATMP_EDITED_FLD
         Address of a double word containing a pointer to the name of
         the field within the resource that contains the time when the
         resource was last edited, if present, followed by its length.
         If no such field exists, the pointer and length are both zero.
         If it is present, the service routine should use this named
         field to locate the value of the timestamp that can be used
         to construct the value returned in the ATMP_EDITED parameter.
         This parameter may be all spaces if the resource does not
         contain such a field.
       ATMP_KEY_FLD
         Address of a double word containing a pointer to the name of
         the field within the resource that contains the key (RIDFLD)
         for File Control operations, if any, followed by its length.
         This is only relevant for key-sequenced VSAM files (KSDS).
       ATMP_TITLE_FLD
         Address of a double word containing a pointer to the name of
         the field within the resource that contains the Atom title of
         the represented entry, if present, followed by its length.
         If it is present, the service routine should use this named
         field to locate the entry title, and return it in the
         DFHATOMTITLE container.
       ATMP_SUBTITLE_FLD
         Address of a double word containing a pointer to the name of
         the field within the resource that contains the Atom subtitle
         of the represented entry, if present, followed by its length.
         If it is present, the service routine should use this named
         field to locate the entry subtitle, and return it in the
         DFHATOMSUBTITLE container.
       ATMP_SUMMARY_FLD
         Address of a double word containing a pointer to the name of
         the field within the resource that contains the Atom summary
         of the represented entry, if present, followed by its length.
         If it is present, the service routine should use this named
         field to locate the entry summary, and return it in the
         DFHATOMSUMMARY container.
       ATMP_CONTENT_FLD
         Address of a double word containing a pointer to the name of
         the field within the resource that contains the whole content
         of the represented entry, if present, followed by its length.
         If this field is not present, the entire contents of the
         record will be returned.
       ATMP_CONTENT_TYPE_FLD
         Address of a double word containing a pointer to the name of
         the field within the resource that contains the content type
         of the represented entry, if present, followed by its length.
         This field is used in combination with ATMP_CONTENT_FLD when
         you are returning data that is not structured XML, such as
         plain text or escaped HTML. If this field is not present,
         a content type of "application/xml" is assumed.
       ATMP_CATEGORY_FLD
         Address of a double word containing a pointer to the name of
         the field within the resource that contains the Atom
         categories of the represented entry, if present, followed by
         its length. If it is present, the service routine should
         use this named field to locate the entry summary, and return
         it in the DFHATOMCATEGORY container.
       ATMP_AUTHOR_FLD
         Address of a double word containing a pointer to the name of
         the field within the resource that contains the name of the
         principal author of the record, followed by its length.
       ATMP_AUTHORURI_FLD
         Address of a double word containing a pointer to the name of
         the field within the resource that contains a URI for the
         principal author of the record, followed by its length.
       ATMP_EMAIL_FLD
         Address of a double word containing a pointer to the name of
         the field within the resource that contains an email address
         for the principal author of the record, followed by its
         length.