Package com.ibm.mq.pcf

Class MQCFGR

java.lang.Object
com.ibm.mq.jmqi.JmqiObject
com.ibm.mq.headers.internal.Header
com.ibm.mq.pcf.PCFHeader
com.ibm.mq.pcf.PCFParameter
com.ibm.mq.pcf.MQCFGR
All Implemented Interfaces:
com.ibm.mq.headers.internal.CachingHeader, MQData, MQHeader, PCFContent
public class MQCFGR extends PCFParameter implements PCFContent
Deprecated.
use MQCFGR instead. 
        struct tagMQCFGR {
                MQLONG  Type;            // Structure type
                MQLONG  StrucLength;     // Structure length
                MQLONG  Parameter;       // Parameter identifier
                MQLONG  ParameterCount;  // Count of group parameter structures
        };
MQCFGR (PCF group parameter) header class.

  • Nested Class Summary

    Nested classes/interfaces inherited from interface com.ibm.mq.headers.MQHeader

    MQHeader.Field

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    int
    parameter
    Deprecated.
    parameter identifier
    int
    parameterCount
    Deprecated.
    Count of group parameter structures
    static final int
    SIZE
    Deprecated.
    prefer PCFHeader.size()
    static final int
    strucLength
    Deprecated.
    structure length
    static final int
    type
    Deprecated.
    structure type

    Fields inherited from class com.ibm.mq.headers.internal.Header

    DEFAULT_CCSID, DEFAULT_ENCODING

    Fields inherited from class com.ibm.mq.jmqi.JmqiObject

    COMP_JM, COMP_JN, COMP_JO

  • Constructor Summary

    Constructors
    Constructor
    Description
    MQCFGR()
    Deprecated.
    Constructs an MQCFGR instance with default field values.
    MQCFGR(MQMessage message)
    Deprecated.
    Constructs an MQCFGR instance populated from an MQMessage.
    MQCFGR(DataInput message, int encoding, int characterSet)
    Deprecated.
    Constructs an MQCFGR instance populated from a DataInput source.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    addFilterParameter(int parameter, int operator, byte[] value)
    Deprecated.
    Adds a bytes string filter parameter to the group.
    void
    addFilterParameter(int parameter, int operator, int value)
    Deprecated.
    Adds an integer filter parameter to the group.
    void
    addFilterParameter(int parameter, int operator, String value)
    Deprecated.
    Adds a string filter parameter to the group.
    void
    addParameter(int parameter, byte[] value)
    Deprecated.
    Adds a byte array parameter to the group.
    void
    addParameter(int parameter, int value)
    Deprecated.
    Adds an integer parameter to the group.
    void
    addParameter(int parameter, int[] values)
    Deprecated.
    Adds an integer list parameter to the group.
    void
    addParameter(int parameter, long value)
    Deprecated.
    Adds a 64-bit integer parameter to the group.
    void
    addParameter(int parameter, long[] values)
    Deprecated.
    Adds a 64-bit integer list parameter to the group.
    void
    addParameter(int parameter, String value)
    Deprecated.
    Adds a string parameter to the group.
    void
    addParameter(int parameter, String[] values)
    Deprecated.
    Adds a string list parameter to the group.
    void
    addParameter(PCFParameter parameter)
    Deprecated.
    Adds a PCFParameter to the group.
    boolean
    equals(Object obj)
    Deprecated.
    Returns true when invoked with another MQCFGR instance with the same parameter, parameterCount, and parameter children.
    byte[]
    getBytesParameterValue(int parameter)
    Deprecated.
    Returns the value of the specified byte array parameter (MQCFBS).
    long
    getInt64ParameterValue(int parameter)
    Deprecated.
    Returns the value of the specified integer parameter (MQCFIN64) as an integer.
    long[]
    getIntList64ParameterValue(int parameter)
    Deprecated.
    Returns the value of the specified integer list parameter (MQCFIL64) as an array of integers.
    int[]
    getIntListParameterValue(int parameter)
    Deprecated.
    Returns the value of the specified integer list parameter (MQCFIL) as an array of integers.
    int
    getIntParameterValue(int parameter)
    Deprecated.
    Returns the value of the specified integer parameter (MQCFIN) as an integer.
    int
    getParameter()
    Deprecated.
    gets the parameter identifier
    PCFParameter
    getParameter(int parameter)
    Deprecated.
    Returns the PCFParameter structure for the specified parameter, or null if the parameter is not found.
    int
    getParameterCount()
    Deprecated.
    gets the count of group parameter structures
    Enumeration
    getParameters()
    Deprecated.
    Returns an enumeration of the parameters in the group.
    Object
    getParameterValue(int parameter)
    Deprecated.
    Returns the value of the specified parameter, or null if the parameter is not found.
    String[]
    getStringListParameterValue(int parameter)
    Deprecated.
    Returns the value of the specified string list parameter (MQCFSL) as an array of strings.
    String
    getStringParameterValue(int parameter)
    Deprecated.
    Returns the value of the specified string parameter (MQCFST) as a string.
    String
    getStringValue()
    Deprecated.
    Get the string value of the parameter
    int
    getStrucLength()
    Deprecated.
    Get the length of the structure.
    int
    getType()
    Deprecated.
    gets the structure type
    Object
    getValue()
    Deprecated.
    Get the value of the parameter
    int
    hashCode()
    Deprecated.
    Returns a hash code value for the object
    int
    read(DataInput message, int encoding, int characterSet)
    Deprecated.
    Reads content from a message or byte stream.
    void
    setParameter(int value)
    Deprecated.
    sets the parameter identifier
    void
    setParameterCount(int value)
    Deprecated.
    Sets the MQCFGR parameter count.
    String
    toString()
    Deprecated.
    return a string representing this header
    static int
    write(MQMessage message, int parameter, int parameterCount)
    Deprecated.
    A convenience method for writing an MQCFGR header structure with the specified values to an MQMessage.

    Methods inherited from class com.ibm.mq.pcf.PCFParameter

    getHeaderVersion, getParameterName, nextParameter

    Methods inherited from class com.ibm.mq.pcf.PCFHeader

    initialize, size, write

    Methods inherited from class com.ibm.mq.headers.internal.Header

    characterSet, encoding, fields, getBytesValue, getCharValue, getCharValue, getIntValue, getJmqiEnv, getStringValue, getValue, headerType, read, read, setBytesValue, setCharValue, setCharValue, setIntValue, setStringValue, setValue, store, store, type, validate, write

    Methods inherited from class com.ibm.mq.jmqi.JmqiObject

    getJmqiEnvironment

    Methods inherited from class java.lang.Object

    getClass, notify, notifyAll, wait, wait, wait

    Methods inherited from interface com.ibm.mq.headers.internal.CachingHeader

    discardCachedContent, readCachedContent, writeCachedContent

  • Field Details

    • SIZE

      public static final int SIZE
      Deprecated.
      prefer PCFHeader.size()
      size of the header in bytes
      See Also:

    • type

      public static final int type
      Deprecated.
      structure type
      See Also:

    • strucLength

      public static final int strucLength
      Deprecated.
      structure length
      See Also:

    • parameter

      public int parameter
      Deprecated.
      parameter identifier

    • parameterCount

      public int parameterCount
      Deprecated.
      Count of group parameter structures

  • Constructor Details

    • MQCFGR

      public MQCFGR()
      Deprecated.
      Constructs an MQCFGR instance with default field values.

    • MQCFGR

      public MQCFGR(MQMessage message) throws MQException, IOException
      Deprecated.
      Constructs an MQCFGR instance populated from an MQMessage.
      Parameters:
      message - the message to read
      Throws:
      MQException - if the message content does not yield a valid MQCFGR stucture
      IOException - if there is a problem reading the message content

    • MQCFGR

      public MQCFGR(DataInput message, int encoding, int characterSet) throws MQException, IOException
      Deprecated.
      Constructs an MQCFGR instance populated from a DataInput source.
      Parameters:
      message - the MQMessage or other DataInput source to read
      encoding - the initial numeric encoding of the data in the message
      characterSet - the initial CCSID of the data in the message
      Throws:
      MQException - if the message content does not yield a valid MQCFGR stucture
      IOException - if there is a problem reading the message content

  • Method Details

    • write

      public static int write(MQMessage message, int parameter, int parameterCount) throws IOException
      Deprecated.
      A convenience method for writing an MQCFGR header structure with the specified values to an MQMessage.
      Parameters:
      message - the message to write to
      parameter - the parameter identifier
      parameterCount - the number of parameter structures enclosed by the group
      Returns:
      the number of bytes written
      Throws:
      IOException - if there is a problem writing the message

    • read

      public int read(DataInput message, int encoding, int characterSet) throws MQException, IOException
      Deprecated.
      Description copied from interface: MQData
      Reads content from a message or byte stream. The content is interpreted (if applicable) using the specified encoding and CCSID.
      Specified by:
      read in interface MQData
      Overrides:
      read in class com.ibm.mq.headers.internal.Header
      Parameters:
      message - the message.
      encoding - the numeric encoding. see (CMQC.MQENC_* for values).
      characterSet - the Coded Character Set Identifier.
      Returns:
      the number of bytes consumed.
      Throws:
      IOException - if an error occurs reading message content.
      MQException
      See Also:
      • Header.read(java.io.DataInput, int, int)

    • getType

      public int getType()
      Deprecated.
      gets the structure type
      Specified by:
      getType in class PCFHeader
      Returns:
      the structure type

    • getStrucLength

      public int getStrucLength()
      Deprecated.
      Get the length of the structure.
      Returns:
      the structure length.

    • getParameter

      public int getParameter()
      Deprecated.
      gets the parameter identifier
      Specified by:
      getParameter in class PCFParameter
      Returns:
      the parameter identifier

    • setParameter

      public void setParameter(int value)
      Deprecated.
      sets the parameter identifier
      Parameters:
      value - the parameter identifier

    • getParameterCount

      public int getParameterCount()
      Deprecated.
      gets the count of group parameter structures
      Specified by:
      getParameterCount in interface PCFContent
      Returns:
      the count of group parameter structures

    • setParameterCount

      public void setParameterCount(int value)
      Deprecated.
      Sets the MQCFGR parameter count. This has the effect of trimming the size of the child PCFParameter collection to the number specified. If the argument is zero, the effect is to clear all child parameters. Specifying a value larger than the current parameter count has no effect. Negative values are ignored.
      Parameters:
      value - the integer value as an Integer object

    • getValue

      public Object getValue()
      Deprecated.
      Description copied from class: PCFParameter
      Get the value of the parameter
      Specified by:
      getValue in class PCFParameter
      Returns:
      Return the value of the parameter
      See Also:

    • getStringValue

      public String getStringValue()
      Deprecated.
      Description copied from class: PCFParameter
      Get the string value of the parameter
      Specified by:
      getStringValue in class PCFParameter
      Returns:
      Returns the string value of the parameter
      See Also:

    • addParameter

      public void addParameter(PCFParameter parameter)
      Deprecated.
      Description copied from interface: PCFContent
      Adds a PCFParameter to the group.
      Specified by:
      addParameter in interface PCFContent
      Parameters:
      parameter - the parameter structure to add (MQCFIN, MQCFIL, MQCFST and so on)
      See Also:

    • addParameter

      public void addParameter(int parameter, int value)
      Deprecated.
      Description copied from interface: PCFContent
      Adds an integer parameter to the group.
      Specified by:
      addParameter in interface PCFContent
      Parameters:
      parameter - the integer parameter identifier
      value - the integer value
      See Also:

    • addParameter

      public void addParameter(int parameter, int[] values)
      Deprecated.
      Description copied from interface: PCFContent
      Adds an integer list parameter to the group.
      Specified by:
      addParameter in interface PCFContent
      Parameters:
      parameter - the integer list parameter identifier
      values - the array of integer values
      See Also:

    • addParameter

      public void addParameter(int parameter, long value)
      Deprecated.
      Description copied from interface: PCFContent
      Adds a 64-bit integer parameter to the group.
      Specified by:
      addParameter in interface PCFContent
      Parameters:
      parameter - the integer parameter identifier
      value - the integer value
      See Also:

    • addParameter

      public void addParameter(int parameter, long[] values)
      Deprecated.
      Description copied from interface: PCFContent
      Adds a 64-bit integer list parameter to the group.
      Specified by:
      addParameter in interface PCFContent
      Parameters:
      parameter - the integer list parameter identifier
      values - the array of integer values
      See Also:

    • addParameter

      public void addParameter(int parameter, String value)
      Deprecated.
      Description copied from interface: PCFContent
      Adds a string parameter to the group.
      Specified by:
      addParameter in interface PCFContent
      Parameters:
      parameter - the string parameter identifier
      value - the string value
      See Also:

    • addParameter

      public void addParameter(int parameter, String[] values)
      Deprecated.
      Description copied from interface: PCFContent
      Adds a string list parameter to the group.
      Specified by:
      addParameter in interface PCFContent
      Parameters:
      parameter - the string list parameter identifier
      values - the array of string values
      See Also:

    • addParameter

      public void addParameter(int parameter, byte[] value)
      Deprecated.
      Description copied from interface: PCFContent
      Adds a byte array parameter to the group.
      Specified by:
      addParameter in interface PCFContent
      Parameters:
      parameter - the string list parameter identifier
      value - the array of string values
      See Also:

    • addFilterParameter

      public void addFilterParameter(int parameter, int operator, int value)
      Deprecated.
      Description copied from interface: PCFContent
      Adds an integer filter parameter to the group.
      Specified by:
      addFilterParameter in interface PCFContent
      Parameters:
      parameter - the filter parameter identifier
      operator - one of the MQCFOP_* filter operator constants
      value - the filter value
      See Also:

    • addFilterParameter

      public void addFilterParameter(int parameter, int operator, String value)
      Deprecated.
      Description copied from interface: PCFContent
      Adds a string filter parameter to the group.
      Specified by:
      addFilterParameter in interface PCFContent
      Parameters:
      parameter - the filter parameter identifier
      operator - one of the MQCFOP_* filter operator constants
      value - the filter value
      See Also:

    • addFilterParameter

      public void addFilterParameter(int parameter, int operator, byte[] value)
      Deprecated.
      Description copied from interface: PCFContent
      Adds a bytes string filter parameter to the group.
      Specified by:
      addFilterParameter in interface PCFContent
      Parameters:
      parameter - the filter parameter identifier
      operator - one of the MQCFOP_* filter operator constants
      value - the filter value
      See Also:

    • getParameters

      public Enumeration getParameters()
      Deprecated.
      Description copied from interface: PCFContent
      Returns an enumeration of the parameters in the group. The elements of the Enumeration returned are individual PCFParameter instances (instances of MQCFIN, MQCFIL, MQCFST or MQCFSL etc.).
      Specified by:
      getParameters in interface PCFContent
      Returns:
      an enumeration of parameters
      See Also:

    • getParameter

      public PCFParameter getParameter(int parameter)
      Deprecated.
      Description copied from interface: PCFContent
      Returns the PCFParameter structure for the specified parameter, or null if the parameter is not found.
      Specified by:
      getParameter in interface PCFContent
      Parameters:
      parameter - for which the PCF structure to be returned
      Returns:
      the specified parameter object
      See Also:

    • getParameterValue

      public Object getParameterValue(int parameter)
      Deprecated.
      Description copied from interface: PCFContent
      Returns the value of the specified parameter, or null if the parameter is not found. The object returned is a single Integer, a single String, an array of integers or array of Strings depending on the type of PCFParameter. The caller can infer the expected return type from the supplied parameter identifier.
      Specified by:
      getParameterValue in interface PCFContent
      Parameters:
      parameter - for which the value to be returned
      Returns:
      the specified parameter value
      See Also:

    • getIntParameterValue

      public int getIntParameterValue(int parameter) throws PCFException
      Deprecated.
      Description copied from interface: PCFContent
      Returns the value of the specified integer parameter (MQCFIN) as an integer.
      Specified by:
      getIntParameterValue in interface PCFContent
      Parameters:
      parameter - the integer parameter identifier
      Returns:
      the integer parameter value
      Throws:
      PCFException - if the specified parameter does not exist in the message (the reason code given is MQRCCF_CFIN_PARM_ID_ERROR)
      See Also:

    • getIntListParameterValue

      public int[] getIntListParameterValue(int parameter) throws PCFException
      Deprecated.
      Description copied from interface: PCFContent
      Returns the value of the specified integer list parameter (MQCFIL) as an array of integers.
      Specified by:
      getIntListParameterValue in interface PCFContent
      Parameters:
      parameter - the integer list parameter identifier
      Returns:
      the integer list parameter values
      Throws:
      PCFException - if the specified parameter does not exist in the group (the reason code given is MQRCCF_CFIL_PARM_ID_ERROR)
      See Also:

    • getInt64ParameterValue

      public long getInt64ParameterValue(int parameter) throws PCFException
      Deprecated.
      Description copied from interface: PCFContent
      Returns the value of the specified integer parameter (MQCFIN64) as an integer.
      Specified by:
      getInt64ParameterValue in interface PCFContent
      Parameters:
      parameter - the integer parameter identifier
      Returns:
      the integer parameter value
      Throws:
      PCFException - if the specified parameter does not exist in the message (the reason code given is MQRCCF_CFIN_PARM_ID_ERROR)
      See Also:

    • getIntList64ParameterValue

      public long[] getIntList64ParameterValue(int parameter) throws PCFException
      Deprecated.
      Description copied from interface: PCFContent
      Returns the value of the specified integer list parameter (MQCFIL64) as an array of integers.
      Specified by:
      getIntList64ParameterValue in interface PCFContent
      Parameters:
      parameter - the integer list parameter identifier
      Returns:
      the integer list parameter values
      Throws:
      PCFException - if the specified parameter does not exist in the group (the reason code given is MQRCCF_CFIL_PARM_ID_ERROR)
      See Also:

    • getStringParameterValue

      public String getStringParameterValue(int parameter) throws PCFException
      Deprecated.
      Description copied from interface: PCFContent
      Returns the value of the specified string parameter (MQCFST) as a string.
      Specified by:
      getStringParameterValue in interface PCFContent
      Parameters:
      parameter - the string parameter identifier
      Returns:
      the string parameter value
      Throws:
      PCFException - if the specified parameter does not exist in the group (the reason code given is MQRCCF_CFST_PARM_ID_ERROR)
      See Also:

    • getStringListParameterValue

      public String[] getStringListParameterValue(int parameter) throws PCFException
      Deprecated.
      Description copied from interface: PCFContent
      Returns the value of the specified string list parameter (MQCFSL) as an array of strings.
      Specified by:
      getStringListParameterValue in interface PCFContent
      Parameters:
      parameter - the string list parameter identifier
      Returns:
      the string list parameter values
      Throws:
      PCFException - if the specified parameter does not exist in the group (the reason code given is MQRCCF_CFSL_PARM_ID_ERROR; no more specific error code is defined)
      See Also:

    • getBytesParameterValue

      public byte[] getBytesParameterValue(int parameter) throws PCFException
      Deprecated.
      Description copied from interface: PCFContent
      Returns the value of the specified byte array parameter (MQCFBS).
      Specified by:
      getBytesParameterValue in interface PCFContent
      Parameters:
      parameter - the byte array parameter identifier
      Returns:
      the byte array parameter value
      Throws:
      PCFException - if the specified parameter does not exist in the group (the reason code given is MQRCCF_CFBS_PARM_ID_ERROR)
      See Also:

    • equals

      public boolean equals(Object obj)
      Deprecated.
      Returns true when invoked with another MQCFGR instance with the same parameter, parameterCount, and parameter children.
      Overrides:
      equals in class PCFParameter
      Parameters:
      obj - An object to compare with this instance
      Returns:
      true of the object equals this one

    • hashCode

      public int hashCode()
      Deprecated.
      Description copied from class: PCFParameter
      Returns a hash code value for the object
      Specified by:
      hashCode in class PCFParameter
      Returns:
      a hash code value for this object.
      See Also:

    • toString

      public String toString()
      Deprecated.
      return a string representing this header
      Overrides:
      toString in class PCFHeader
      Returns:
      the string
      See Also: