Table of Contents Previous Next PDF


MBeans and JMX Operations

MBeans and JMX Operations
This chapter lists all the MBeans and related operations in JMX Agent.
Admin MBean
MBean Name
DefaultJMXDomain:type=adminBean
Operations
Boot Domain
Change the domain to active state.
Note:
You must connect the JMX Agent in the master machine, and add NONTUXAUTH in the credential list. After it is booted successfully, you must reconnect the JMX Agent without NONTUXAUTH in the credential list to invoke other JMX methods.
Input:
tuxconfig: The tuxconfig path of master machine.
onlyAppServers: All servers listed in the SERVERS section are booted
onlyAdminServers: All administrative servers are booted.
Signature:
void bootDomain(String tuxconfig, Boolean onlyAppServers, boolean onlyAdminServers) throws USGException, SYSException, TUXException
Shutdown Domain
Make the domain to deactive state. When onlyAppServers and onlyAdminServers are false, this method stops all administrative, TMS, and gateway servers, and servers listed in the SERVERS section of the configuration file named by the TUXCONFIG environment variable, and removes the IPC resources associated with them. For each group, all servers in the SERVERS section, if any, are shut down, followed by any associated gateway servers (for foreign groups) and TMS servers. Administrative servers are shut down last.
Application servers without SEQUENCE parameters are shut down first in reverse order of the server entries in the configuration file, followed by servers with SEQUENCE parameters that are shut down from high to low sequence number. If two or more servers in the SERVERS section of the configuration file have the same SEQUENCE parameter, this method may shut down these servers in parallel. Each entry in the SERVERS section may have an optional MIN and MAX parameter.
Note:
Input:
tuxconfig: The tuxconfig path of master machine.
onlyAppServers: All servers listed in the SERVERS section are shut down.
onlyAdminServers: All administrative servers are shut down.
delay: Suspends all selected servers immediately and waits for shutdown confirmation for only delay seconds before forcing the server to shut down by sending a SIGTERM and then a SIGKILL signal to the server.
signal: {null|""|TERM|KILL}. null|"" is treated as TERM.
force : Shuts down BBLs even if clients are still attached.
Signature:
void shutdownDomain(String tuxconfig, Boolean onlyAppServers, boolean onlyAdminServers, Integer delay, String signal, boolean force) throws USGException, SYSException, TUXException, JMXConnectionException
Boot Machine
For each group whose associated LMID parameter is lmid, all TMS and gateway servers associated with the group are booted and all servers in the SERVERS section associated with those groups are executed.
Note:
Input
tuxconfig: The tuxconfig path of master machine.
lmid: The lmid of machine.
isBootBBL: Specify whether the BBL should be started on with logical name lmid.
Signature
void bootMachine(String tuxconfig, String lmid, Boolean isBootBBL) throws USGException, SYSException, TUXException
Shutdown Machine
For each group whose associated LMID parameter is lmid, all servers in the SERVERS section associated with the group are shut down, followed by any TMS and gateway servers associated with the group.
Note:
Input:
tuxconfig: The tuxconfig path of master machine.
lmid: The lmid of machine.
delay: Suspends all selected servers immediately and waits for shutdown confirmation for only delay seconds before forcing the server to shut down by sending a SIGTERM and then a SIGKILL signal to the server.
signal: {null|""|TERM|KILL}. null|"" is treated as TERM.
force : Shuts down BBLs even if clients are still attached.
Signature
void shutdownMachine (String tuxconfig, String lmid, Integer delay, String signal, Boolean force) throws USGException, SYSException, JMXConnectionException, TUXException
Boot Group
All TMS and gateway servers for the group whose SRVGRP parameter is grpname are started, followed by all servers in the SERVERS section associated with that group. TMS servers are started based on the TMSNAME and TMSCOUNT parameters for the group entry.
Note:
Input
tuxconfig: The tuxconfig path of the machine which group is located in.
grpname: The name of Tuxedo group.
Signature
void bootGroup(String tuxconfig, String grpname)throws USGException, SYSException, TUXException
Shutdown Group
All servers in the SERVERS section associated with the specified group (that is, for which the SRVGRP parameter is set to grpname) are shut down, followed by all TMS and gateway servers for the group. TMS servers are shut down based on the TMSNAME and TMSCOUNT parameters for the group entry. For a foreign group, the gateway servers for the associated entry in the HOST section are shut down based on GATENAME and GATECOUNT. Shutting down a gateway implies not only that the process itself is stopped; it also implies that the administrative service for the gateway and all advertised foreign services are unadvertised.
Note:
Input
tuxconfig: The tuxconfig path of the machine which group is located in.
grpname: The name of group.
delay: Suspends all selected servers immediately and waits for shutdown confirmation for only delay seconds before forcing the server to shut down by sending a SIGTERM and then a SIGKILL signal to the server. Because the SIGKILL signal cannot be trapped, any process that receives it is terminated immediately, regardless of the code being executed by the process at that time. Such behavior may cause structural damage to the bulletin board if the process being stopped was updating the bulletin board when it was terminated.
signal:{null|""|TERM|KILL}. null|"" is treated as TERM.
Signature
void shutdownGroup(String tuxconfig, String grpname, Integer delay, String signal)throws USGException, SYSException, TUXException, JMXConnectionException
Boot Server
All servers in the SERVERS section whose SRVID parameter is serverID are executed.
Note: Must connect the JMX Agent in the master machine.
Input
tuxconfig: The tuxconfig path of the machine which group is located in.
groupname: The namename of Tuxedo group.
serverID: The SVRID
Signature
void bootServer(String tuxconfig, String groupname, Integer serverID) throws USGException, SYSException, TUXException
Activate All Servers with Same Name
All servers in the SERVERS section are executed by server name and MIN value. Servers with a MIN=0 value are not executed.
Note: Must connect the JMX Agent in the master machine.
Input
tuxconfig: The tuxconfig path of the machine which the group is located in.
aout: The Tuxedo server name
Signature
void bootServer(String tuxconfig, String aout)throws USGException, SYSException, TUXException
Shutdown Server
All servers in the SERVERS section for which the SRVID parameter is set to serverID are shut down. Do not enter a value for SRVID greater than 30,000; this indicates system processes (that is, TMSs or gateway servers) that should only be shut down via the shutdownMachine or shutdownGroup.
Note: Must connect the JMX Agent in the master machine.
Input
tuxconfig: The tuxconfig path of the machine which the server is located in.
grpname: The name of Tuxedo group.
serverid: The SVRID
delay: Suspends all selected servers immediately and waits for shutdown confirmation for only delay seconds before forcing the server to shut down by sending a SIGTERM and then a SIGKILL signal to the server. Because the SIGKILL signal cannot be trapped, any process that receives it is terminated immediately, regardless of the code being executed by the process at that time. Such behavior may cause structural damage to the bulletin board if the process being stopped was updating the bulletin board when it was terminated.
signal:{null|""|TERM|KILL}. null|"" is treated as TERM.
Signature
void shutdownServer(String tuxconfig, String groupname, Integer serverId, Integer delay, String signal)throws USGException, SYSException, TUXException
Shutdown All the Servers with Same Name
All servers listed in the SERVERS section with the name aout are shut down. This method can also be used to shut down System server, TMS and gateway servers.
Note: Must connect the JMX Agent in the master machine.
Input
tuxconfig: The tuxconfig path of the machine which group is located in.
aout: The Tuxedo server name.
delay: Suspends all selected servers immediately and waits for shutdown confirmation for only delay seconds before forcing the server to shut down by sending a SIGTERM and then a SIGKILL signal to the server. Because the SIGKILL signal cannot be trapped, any process that receives it is terminated immediately, regardless of the code being executed by the process at that time. Such behavior may cause structural damage to the bulletin board if the process being stopped was updating the bulletin board when it was terminated.
signal:{null|""|TERM|KILL}. null|"" is treated as TERM.
Signature
void shutdownServer(String tuxconfig, String aout, Integer delay, String signal)throws USGException, SYSException, TUXException
Tuxedo Domain MBean
MBean Name
“<DOMAINID>_<IPCKEY>:type=tuxedo_domain”.
Operations
CreateMachine
Create a Tuxedo machine instance and an MBean with tuxedo_machine type. The machine target will not be booted after the creation action. You need to create the bridge target then boot the machine.
Input:
pmid The machine pmid.
lmid The machine lmid.
tuxconfig The machine tuxconfig.
tuxdir The Tuxedo installation directory in the created machine.
appdir The application directory for the machine application.
Signature
void createMachine (String pmid, String lmid, String tuxconfig, String tuxdir, String appdir) throws MBeanException, SYSException,TUXException, JMXConnectionException, USGException
GetParameters
Get values for the attributes in T_DOMAIN which has the same IPCKEY with this MBean.
Signature
CompositeData getParameters() throws SYSException, JMXConnectionException, TUXException, OpenDataException;
GetParameter
Get value for the attribute in T_DOMAIN which has the same IPCKEY with this MBean.
Input:
parameterName: The MIB attribute name.
Signature
Object getParameter(String parameterName) throws USGException, TUXException, SYSException, JMXConnectionException;
SetParameter
Set value for the attribute in T_DOMAIN which has the same IPCKEY with this MBean.
Input:
parameterName The MIB attribute name.
parameterValue The MIB attribute value.
Signature
void setParameter(String parameterName, Object parameterValue) throws TUXException, USGException, SYSException, JMXConnectionException, MBeanException;
SetParameters
Set value for the attributes in T_DOMAIN which has the same IPCKEY with this MBean.
Input
parameters: The list of parameters and values in the format of CompositeData. The itemNames for parameters is the MIB attributes name which are start with “TA_”. The itemTypes is the OpenType corresponding to the MIB attributes type. And the values are the parameter’s value.
Following is the type mapping between OpenType and MIB Field Type.
 
Signature
Object setParameters(CompositeData parameters) throws USGException, SYSException, TUXException, JMXConnectionException, MBeanException;
Get Routings
Get the routings from T_ROUTING class.
Signature
TabularData getRoutings () throws SYSException, TUXException, JMXConnectionException;
Add Routing
Add routing to T_ROUTING class. Please make sure the MAXRFT and MAXDRT is validate for add routing.
Input:
 
Signature
void addRouting(String routingName, String routingType, String bufType, String field, String ranges) throws SYSException, TUXException, JMXConnectionException, OpenDataException;
Delete Routing
Delete routing from this domain.
Input:
 
Signature
void deleteRouting(String routingName, String buftype , String field, String type) throws SYSException, TUXException, JMXConnectionException;
Set Routing Parameters
Set the attributes value in T_ROUTING.
Input:
 
Signature
void setRoutingParameters (String routingName, String buftype, String field, String type, CompositeData parameters) throws USGException, TUXException, JMXConnectionException, SYSException;
Set Routing Parameter
Set the attribute value in T_ROUTING.
Input:
 
Signature
void setRoutingParameter(String routingName, String buftype, String field, String type, String parameterName, String parameterValue) throws JMXConnectionException, SYSException, USGException, TUXException;
Get Routing Parameter
Get the attribute’s value in T_ROUTING.
Input:
 
Signature:
Object getRoutingParameter(String routingName, String buftype, String field, String type, String parameterName) USGException, TUXException, JMXConnectionException, SYSException;
Swap
Swap the master and backup which is configured in MASTER parameter.
Signature
void swap() throws TUXException, JMXConnectionException,SYSException
Tuxedo Machine MBean
MBean Name
“<DOMAINID>_<IPCKEY>:type= tuxedo_machine,LMID=<LMID>”.
Operations
Create Group
Create a Tuxedo group instance and an MBean with tuxedo_group type. The created target is not active. You need to invoke the active method for the activation.
Signature
void createGroup (String groupName, Integer groupNo) throws SYSException, MBeanException, USGException, TUXException, JMXConnectionException
Create Bridge
Create a Tuxedo Bridge instance and an MBean with tuxedo_bridge type. The created target is not active. You need to invoke the active method for the activation.
Signature
void createBridge (String lmid, String naddr, String nlsaddr) throws SYSException, MBeanException, USGException, TUXException, JMXConnectionException
GetParameter
Get value for the attribute in T_MACHINE which has the same LMID with this MBean.
Input:
parameterName: The MIB attribute name.
Signature
Object getParameter(String parameterName) throws USGException, TUXException, SYSException, JMXConnectionException;
GetParameters
Get value for all attributes in T_ MACHINE which has the same LMID with this MBean.
Signature
CompositeData getParameters() throws SYSException, JMXConnectionException, TUXException, OpenDataException;
SetParameter
Set value for the attribute in T_ MACHINE which has the same LMID with this MBean.
Input:
parameterName The MIB attribute name.
parameterValue The MIB attribute value.
Signature
void setParameter(String parameterName, String parameterValue) throws TUXException, USGException, SYSException, JMXConnectionException, MBeanException;
SetParameters
Set value for the attributes in T_MACHINE which has the same LMID with this MBean.
Input
Refer to the input for “SetParameters” on page 4‑8.
Signature
Object setParameters(CompositeData parameters) throws USGException, SYSException, TUXException, JMXConnectionException, MBeanException;
deleteRecursively
Delete all the Tuxedo instances and child instances associated with the MBean
Signature
void deleteRecursively () throws MBeanException, TUXException, JMXConnectionException, SYSException, USGException;
Delete
Delete the Tuxedo instances associated with this MBean.
Note:
Signature
void delete() throws TUXException, USGException, SYSException, JMXConnectionException, MBeanException;
Migrate
All servers running on the machine are migrated to their alternate location. RESTART=Y must be configured in server section for all the servers which need be migrated.
Signature
void migrate() throws Exception
Clean
Initiate cleanup/scanning activities on and relating to the indicated machine. If there are dead clients or servers on the machine, they will be detected at this time. If the machine has been partitioned from the application MASTER site, global bulletin board entries for that machine will be removed. This combination is allowed when the application is in the ACTive state and the machine is in either the ACTive or PARtitioned state. Successful return for a non-partitioned machine leaves the state unchanged. Successful return for a partitioned machine leaves the object in the INActive state.
Signature
void clean() throws MBeanException, JMXConnectionException, TUXException, SYSException
Get Native Clients
Get all the native clients which are running on the machine.
Output
TablarData columns:
:
Signature
TabularData getNativeClients() throws TUXException, JMXConnectionException, SYSException
Suspend
Suspend the client from making service requests (tpcall() or tpacall()), initiating conversations (tpconnect()), beginning transactions (tpbegin()), and enqueuing new requests (tpenqueue()). Clients within a transaction will be permitted to make these calls until they abort or commit the current transaction, at which time they will become suspended. Invocations of these routines will result in a TPESYSTEM error return and a system log message being generated indicating the situation. State change allowed only when in the ACTive state. Successful return leaves the object in the SUSpended state.
Input
clientId: Client identifier.
Signature
void suspend(String clientId) throws TUXException, SYSException, JMXConnectionException
Resume
Change the client`s state from “SUSpended” to “ACTive”. Successful return leaves the object in the “ACTive” state.
Input
clientID: Client identifier.
Signature
void resume(String clientId) throws TUXException, SYSException, JMXConnectionException
Kill Client
Abortively deactivate the client. State change allowed only when in the “ACTive” or “SUSpended” state. Limitation: The system may not be able to kill the client due to platform or signaling restrictions. In this case, a native client will be abortively terminated at its next access to ATMI.
Input
clientId: Client identifier.
Signature
void killClient(String clientId) throws TUXException, SYSException, JMXConnectionException
Get Transactions
Get all the transactions which belong to the machine. Note that transaction attributes are primarily kept local to a site and coordinated via common transaction identifiers by transaction management servers (TMSs).
Output
TablarData columns:
 
Signature
TabularData getTransations() throws TUXException, JMXConnectionException, SYSException;
Abort Transaction
Abort the transaction for the application. State change allowed only when in the ACTive, ABortonlY, or COMcalled states. Successful return leaves the transaction in the ABorteD state.
Input
TPTRANID: (TA_TPTRANID) Transaction identifier as returned from tpsuspend() mapped to a string representation.
XID: TA_XID Transaction identifier as returned from tx_info() mapped to a string representation.
Signature
void abortTransaction(StringTPTRANID, String XID) throws TUXException, JMXConnectionException, SYSException
Get ULOGs
Get ULOGs in the machine.
Input
date: Date of user log file found or to be accessed. In the format of MMDDYY
startTime: The time of the user log message represented by this object. The value of this attribute is formed by multiplying the hour by 10,000, adding to that the minute multiplied by 100, and finally adding in the seconds. When used as a key field, this attribute represents the start of the time range to be accessed for messages. In the format of hhmmss
endTime: The latest time to be considered when accessing this userlog file. In the format of hhmmss
line: The line number of the user log message returned/requested within the user log file. When used as a key field for retrieval, this value indicates the starting line within the log file.
ulogCat: Catalog name from which the message was derived, if any.
serverity: Severity of message, if any.
totalLine: Total Line number for request.
Output
 
Signature
TabularData getULog(Integer date, Integer startTime, Integer endTime, Integer line,String ulogCat, String serverity, Integer totalLine)throws JMXConnectionException, TUXException, SYSException
Tuxedo Group MBean
MBean Name
“<DOMAINID>_<IPCKEY>:type=tuxedo_group,group_name=<GROUPNAME>”.
Operations
Create Server
Create a Tuxedo Server instance and an MBean with tuxedo_server/tuxedo_system_server/ tuxedo_domain_gateway/ tuxedo_event_broker/ tuxedo_jolt_listener/ tuxedo_TMA_gateway_SNA/ tuxedo_TMA_gateway_TCP/ tuxedo_LMS/ tuxedo_webservice_gateway/ tuxedo_workstation_listener type depends on the aoutserver name.
Signature
void createServer (String aout, Integer srvID) throws SYSException, MBeanException, USGException, TUXException, JMXConnectionException;
GetParameter
Get value for the attribute in T_GROUP which has the same group name with this MBean.
Input:
parameterName: The MIB attribute name.
Signature
Object getParameter(String parameterName) throws USGException, TUXException, SYSException, JMXConnectionException;
GetParameters
Get values for all attribute in T_ GROUP which has the same group name with this MBean.
Signature
CompositeData getParameters() throws SYSException, JMXConnectionException, TUXException, OpenDataException;
SetParameter
Set value for the attribute in T_ GROUP which has the same group name with this MBean.
Input:
parameterName: The MIB attribute name.
parameterValue: The MIB attribute value.
Signature:
void setParameter(String parameterName, String parameterValue) throws TUXException, USGException, SYSException, JMXConnectionException, MBeanException;
SetParameters
Set value for the attributes in T_ GROUP which has the same group name with this MBean.
Input
Refer to the input for “SetParameters” on page 4‑8.
Signature
Object setParameters(CompositeData parameters) throws USGException, SYSException, TUXException, JMXConnectionException, MBeanException;
CreateTMS
Create TMS.
Input
 
Signature
void createTMS (String rmsName, Integer rmid, String tmsName);
deleteRecursively
Delete all the Tuxedo instances and Child instances associated with the MBean
Signature
void deleteRecursively () throws MBeanException, TUXException, JMXConnectionException, SYSException, USGException;
Delete
Delete all Tuxedo instances associated with the MBean.
Note:
Signature
void delete() throws TUXException, USGException, SYSException, JMXConnectionException, MBeanException;
Migrate
If the configuration file specifies the MIGRATE option and an alternate location for the group, all servers in the group are migrated to the alternate location.
Note:
Signature
void migrate()throws Exception
Tuxedo Server MBean
MBean Name
“<DOMAINID>_<IPCKEY>: tuxedo_server,group_name=< SRVGRP>, SRVID=<SRVID>”.
Operations
GetParameter
Get value for the attribute in T_SERVER which has the same SRVID and SRVGRP with this MBean.
Input:
parameterName: The MIB attribute name. For example: “TA_MAX”.
Signature
Object getParameter(String parameterName) throws USGException, TUXException, SYSException, JMXConnectionException;
GetParameters
Get all attribute and values in T_ SERVER with the MBean’s SRVID and SRVGRP.
Signature
CompositeData getParameters() throws SYSException, JMXConnectionException, TUXException, OpenDataException;
SetParameter
Set value for the attribute in T_ SERVER which has the same SRVID and SRVGRP with this MBean.
Input:
parameterName: The MIB attribute name.
parameterValue: The MIB attribute value.
Signature:
void setParameter(String parameterName, String parameterValue) throws TUXException, USGException, SYSException, JMXConnectionException, MBeanException;
SetParameters
Set value for the attributes in T_ SERVER which has the same SRVID and SRVGRP with this MBean.
Input
Refer to the input for “SetParameters” on page 4‑8.
Signature
Object setParameters(CompositeData parameters) throws USGException, SYSException, TUXException, JMXConnectionException, MBeanException;
Delete
Delete both the MBean and all Tuxedo instances associated with the MBean.
Signature
void delete() throws TUXException, USGException, SYSException, JMXConnectionException, MBeanException;
Set Service parameter
Set value for the attribute in T_ SERVICE which has the same SRVID and SRVGRP with this MBean.
Input
serviceName: name of service.
parameterName: The MIB attribute name.
parameterValue: The MIB attribute value.
Signature
void setServiceParameter(String serviceName, String parameterName, String parameterValue) throws TUXException, SYSException, JMXConnectionException, USGException;
Get Service Parameter
Get the value of attribute in T_ SERVICE which has the same SRVID and SRVGRP with this MBean.
Input
serviceName: name of service.
parameterName: The MIB attribute name.
Signature
Object getServiceParameter(String serviceName, String parameterName) throws MBeanException, TUXException, JMXConnectionException,SYSException;
Delete Service
Delete service from T_SERVICE.
Input
serviceName: name of Tuxedo service.
Signature
Object deleteService (String serviceName) throws SYSException, TUXException, USGException, JMXConnectionException, MBeanException;
Get Service
Get all the services from T_SERVICE
Output
TablarData columns:
 
Signature
TabularData getServices()throws SYSException, TUXException, JMXConnectionException
Suspend Service
Limitation: State change not permitted for service names (TA_SERVICENAME) beginning with the reserved string “_”.
Input
serviceName: TA_SERVICENAME Service name.
Signature
void suspendService(String serviceName) throws USGException, JMXConnectionException, TUXException, SYSException
Resume Service
Activate (advertise) the service instance. State change allowed only when in the “INActive”, “SUSpended” or “INValid” states. For the purpose of determining permissions for this state transition, the active object permissions are considered (that is, --x--x--x). Successful return leaves the object in the “ACTive” state.
Limitation: State change not permitted for service names (TA_SERVICENAME) beginning with the reserved string “.”.
Input
serviceName: TA_SERVICENAME
Signature
void resumeService(String serviceName) throws USGException, JMXConnectionException, TUXException, SYSException
Tuxedo System Server Mbean
Following server be modeled as system server MBean.
 
MBean Name
“<DOMAINID>_<IPCKEY>:type=tuxedo_system_server,group_name=<GROUPNAME>,SRVID=<SRVID>”.
Operations
GetParameter
Get value for the attribute in T_SERVER which has the same SRVID and SRVGRP with this MBean.
Input:
parameterName: The MIB attribute name. For example: “TA_MAX”.
Signature
Object getParameter(String parameterName) throws USGException, TUXException, SYSException, JMXConnectionException;
GetParameters
Get all attribute and values in T_ SERVER which has the same SRVID and SRVGRP with this MBean.
Signature
CompositeData getParameters() throws SYSException, JMXConnectionException, TUXException, OpenDataException;
SetParameter
Set value for the attribute in T_ SERVER which has the same SRVID and SRVGRP with this MBean.
Input:
parameterName: The MIB attribute name.
parameterValue: The MIB attribute value.
Signature:
void setParameter(String parameterName, String parameterValue) throws TUXException, USGException, SYSException, JMXConnectionException, MBeanException;
SetParameters
Set value for the attributes in T_ SERVER which has the same SRVID and SRVGRP with this MBean.
Input
Refer to the input for “SetParameters” on page 4‑8.
Signature
Object setParameters(CompositeData parameters) throws USGException, SYSException, TUXException, JMXConnectionException, MBeanException;
Delete
Delete both the MBean and all Tuxedo instances associated with the MBean.
Signature
void delete() throws TUXException, USGException, SYSException, JMXConnectionException, MBeanException;
Tuxedo Bridge MBean
MBean Name
“<DOMAINID>_<IPCKEY>:type= tuxedo_bridge, LMID=<LMID>”.
LMID: specify the LMID parameter associated with the Tuxedo Machine where the bridge is running.
Operations
GetParameter
Get value for the attribute in T_BRIDGE which has the same LMID with this MBean.
Input:
parameterName: The MIB attribute name. For example: “TA_SENTNUM”.
Signature
Object getParameter(String parameterName) throws USGException, TUXException, SYSException, JMXConnectionException;
GetParameters
Get all attribute and values in T_ BRIDGE with which has the same LMID with this MBean.
Signature
CompositeData getParameters() throws SYSException, JMXConnectionException, TUXException, OpenDataException;
Get Remote Link Parameter
Get remote link`s parameter value.
Input:
remoteLMID: The LMID for remote machine.
parameterName: The MIB attribute Name in T_BRIDGE
Signature
Object getRemoteLinkParameter(String remoteLMID, String parameterName) throws TUXException,JMXConnectionException, SYSException;
Get Remote Links
Get all network connections in this bridge server.
Output
 
Signature
TabularData getRemoteLinks ()throws TUXException, JMXConnectionException, SYSException
Set Remote Link Parameters
Set the parameter for remote link in T_BRIDGE class
Signature
setRemoteLinkParameters(String remoteLMID, CompositeData parameters) throws TUXException, JMXConnectionException, SYSException, USGException
Suspend Remote Link
Suspend the remote link by closing the connection between the indicated logical machines. State change allowed only when in the ACTive state. Successful return leaves the object in the SUSpended state. Limitation: Note that since the statistics reported are from the viewpoint of the source logical machine, resetting those statistics will cause them to be out of sync with the statistics reported by the destination logical machine for the same connection.
Input
remoteLmid: Remote machine's LMID.
Signature
void suspend (String remoteLmid)throws USGException, TUXException, SYSException, JMXConnectionException;
Resume Remote Link
Reactivate the connection. This operation will fail if remoteLmid is null, if the remoteLmid is equals to the bridge Mean’s lmid, if either of the two machines is not active, or if the source logical machine is not reachable. For the purpose of determining permissions for this state transition, the active object permissions are considered (that is, --x--x--x). Successful return leaves the object in the PENding state.
Input
remoteLmid: Remote machine's LMID.
Signature
void resume(String remoteLmid)throws USGException, TUXException, SYSException, JMXConnectionException
Deactivate Remote Link
Close the connection between the indicated logical machines. This operation will fail if only remoteLmid is null, if the remoteLmid is equals to the bridge mbean`s lmid or if the two machines are not connected. State change allowed only when in the ACTive state. Successful return leaves the object in the INActive state.
Input
remoteLmid: Remote machine's LMID.
Signature
void deactive(String remoteLmid)throws USGException, TUXException, SYSException, JMXConnectionException
Tuxedo TMS Mbean
MBean Name
“<DOMAINID>_<IPCKEY>:type= tuxedo_TMS,group_name=<GROUPNAME>,aout=<TMSNAME>,rmsname=<RMSNAME>”.
RMSNAME: specifies the RMSNAME parameter associated with the Tuxedo TMS.
Operations
GetParameter
Get value for the attribute in T_SERVER which has the same SRVID, SRVGRP, RMSNAME and TMSNAME with this MBean.
Input:
parameterName: The MIB attribute name.
Signature
Object getParameter(String parameterName) throws USGException, TUXException, SYSException, JMXConnectionException;
GetParameters
Get all attribute and values in T_ SERVER which has the same SRVID, SRVGRP, RMSNAME and TMSNAME with this MBean.
Signature
CompositeData getParameters() throws SYSException, JMXConnectionException, TUXException, OpenDataException;
SetParameter
Set value for the attribute in T_ SERVER which has the same SRVID, SRVGRP, RMSNAME and TMSNAME with this MBean.
Input:
parameterName: The MIB attribute name.
parameterValue: The MIB attribute value.
Signature:
void setParameter(String parameterName, String parameterValue) throws TUXException, USGException, SYSException, JMXConnectionException, MBeanException;
SetParameters
Set value for the attributes in T_ SERVER which has the same SRVID, SRVGRP, RMSNAME and TMSNAME with this MBean.
Input
Refer to the input for “SetParameters” on page 4‑8.
Signature
Object setParameters(CompositeData parameters) throws USGException, SYSException, TUXException, JMXConnectionException, MBeanException;
Delete
Delete both the MBean and all Tuxedo instances associated with the MBean.
Signature
void delete() throws TUXException, USGException, SYSException, JMXConnectionException, MBeanException;
Tuxedo /T Domain Gateway
MBean Name
“<DOMAINID>_<IPCKEY>:type= tuxedo_domain_gateway,group_name=<GROUPNAME>,SRVID=<SRVID>”.
Operations
GetParameter
Refer to “GetParameter” on page 4‑20.
GetParameters
Refer to “GetParameters” on page 4‑20.
SetParameter
Refer to “SetParameter” on page 4‑20.
SetParameters
Refer to “SetParameters” on page 4‑21.
Delete
Refer to “Delete” on page 4‑21.
Tuxedo Mainframe Adapter Gateway for SNA
MBean Name
“<DOMAINID>_<IPCKEY>:type= tuxedo_TMA_gateway_SNA,group_name=<GROUPNAME>,SRVID=<SRVID>”.
Operations
GetParameter
Refer to “GetParameter” on page 4‑20.
GetParameters
Refer to “GetParameters” on page 4‑20.
SetParameter
Refer to “SetParameter” on page 4‑20.
SetParameters
Refer to “SetParameters” on page 4‑21.
Delete
Refer to “Delete” on page 4‑21.
Tuxedo Mainframe Adapter Gateway for TCP
MBean Name
“<DOMAINID>_<IPCKEY>:type= tuxedo_TMA_gateway_TCP,group_name=<GROUPNAME>,SRVID=<SRVID>”.
Operations
GetParameter
Refer to “GetParameter” on page 4‑20.
GetParameters
Refer to “GetParameters” on page 4‑20.
SetParameter
Refer to “SetParameter” on page 4‑20.
SetParameters
Refer to “SetParameters” on page 4‑21.
Delete
Refer to “Delete” on page 4‑21.
Tuxedo Web Service Gateway
MBean Name
“<DOMAINID>_<IPCKEY>:type= tuxedo_webservice_gateway,group_name=<GROUPNAME>,SRVID=<SRVID>”.
Operations
GetParameter
Refer to “GetParameter” on page 4‑20.
GetParameters
Refer to “GetParameters” on page 4‑20.
SetParameter
Refer to “SetParameter” on page 4‑20.
SetParameters
Refer to “SetParameters” on page 4‑21.
Delete
Refer to “Delete” on page 4‑21.
Tuxedo Workstation Listener
MBean Name
“<DOMAINID>_<IPCKEY>:type= tuxedo_workstation_listener,group_name=<GROUPNAME>,SRVID=<SRVID>”.
Operations
GetParameter
Get value for the attribute in T_WSL .
Input:
parameterName: The MIB attribute name.
Signature
Object getParameter(String parameterName) throws USGException, TUXException, SYSException, JMXConnectionException;
GetParameters
Get all attribute and values in T_ WSL.
Signature
CompositeData getParameters() throws SYSException, JMXConnectionException, TUXException, OpenDataException;
SetParameter
Set value for the attribute in T_ WSL.
Input:
parameterName: The MIB attribute name.
parameterValue: The MIB attribute value.
Signature:
void setParameter(String parameterName, String parameterValue) throws TUXException, USGException, SYSException, JMXConnectionException, MBeanException;
SetParameters
Set value for the attributes in T_ WSL.
Input
Refer to the input for “SetParameters” on page 4‑8.
Signature
Object setParameters(CompositeData parameters) throws USGException, SYSException, TUXException, JMXConnectionException, MBeanException;
Delete
Refer to “Delete” on page 4‑21.
Get Handler Parameter
Get attribute value in T_WSH.
Input:
clientId: TA_CLIENTID
parameterName: The MIB attribute name. For example: “TA_HWCLIENTS”.
Signature
Object getHandlerParameter(String clientId, String parameterName) throw USGException, TUXException, JMXConnectionException, SYSException;
Get Handlers
Get all handlers associated with the WSL.
Input
ClientId: If clientId is null, all handlers will be return.
Signature
TabularData getHandlers(String clientId) throws TUXException, JMXConnectionException, SYSException;
Suspend Handler
Change the State of WSH to “SUSpended”. Note: State changes to the “SUSpended” state are transitive to all clients associated with this WSH as is the resetting of a “SUSpended” WSH to “ACTive”. Additionally, “SUSpended” WSH clients will not be assigned any additional incoming clients by the WSL.
Input:
clientId: Client identifier for this WSH.
Signature:
void suspendHandler (String clientId) throws TUXException, JMXConnectionException, SYSException, USGException, MBeanException;
Resume Handler
Set the State of WSH to “ACTive”.
Input
clientId: Client identifier for this WSH.
Signature
void resumeHandler (String clientId)) throws TUXException, JMXConnectionException, SYSException, USGException, MBeanException;
Kill Handler
Set the State of WSH to “DEAD”, and all connections being handled by the targeted WSH to be dropped abortively.
Input
clientId: Client identifier for this WSH.
Signature
void killHandler (String clientId) throws TUXException, JMXConnectionException, SYSException, MBeanException, USGException;
Get Clients
Get all the clients associated with the WSH.
Input
wshClientID: WSH`s identifier.
Signature
TabularData getWSClients(String wshClientID) throws TUXException, JMXConnectionException, SYSException
Suspend Client
Suspend the client object from making service requests (tpcall() or tpacall()), initiating conversations (tpconnect()), beginning transactions (tpbegin()), and enqueuing new requests (tpenqueue()). Clients within a transaction will be permitted to make these calls until they abort or commit the current transaction, at which time they will become suspended. Invocations of these routines will result in a TPESYSTEM error return and a system log message being generated indicating the situation. State change allowed only when in the ACTive state. Successful return leaves the object in the SUSpended state.
Input:
clientId: Client identifier.
Signature
Void suspendClient(String clientId) throws TUXException, JMXConnectionException, SYSException;
Resume Client
Activate a SUSpended client object. State change allowed only when in the SUSpended state. Successful return leaves the object in the ACTive state.
Input:
clientId: Client identifier.
Signature:
void resumeClient (String clientId) throws TUXException, JMXConnectionException, SYSException;
Kill Client
Abortively deactivate the client object. State change allowed only when in the ACTive or SUSpended state. The system may not be able to kill the client due to platform or signaling restrictions. In this case, a Workstation client's connection to a WSH will be preemptively torn down.
Input
clientId: Client identifier.
Signature
Void killClient(String clientId) throws TUXException, JMXConnectionException, SYSException;
Tuxedo Jolt Listener
MBean Name
“<DOMAINID>_<IPCKEY>:type= tuxedo_jolt_listener,group_name=<GROUPNAME>,SRVID=<SRVID>”.
Operations
GetParameter
Get value for the attribute in T_JSL .
Input:
parameterName: The MIB attribute name.
Signature
Object getParameter(String parameterName) throws USGException, TUXException, SYSException, JMXConnectionException;
GetParameters
Get all attribute and values in T_ JSL.
Signature
CompositeData getParameters() throws SYSException, JMXConnectionException, TUXException, OpenDataException;
SetParameter
Set value for the attribute in T_ JSL.
Input:
parameterName: The MIB attribute name.
parameterValue: The MIB attribute value.
Signature:
void setParameter(String parameterName, String parameterValue) throws TUXException, USGException, SYSException, JMXConnectionException, MBeanException;
SetParameters
Set value for the attributes in T_ JSL.
Input
Refer to the input for “SetParameters” on page 4‑8.
Signature
Object setParameters(CompositeData parameters) throws USGException, SYSException, TUXException, JMXConnectionException, MBeanException;
Delete JSL
Refer to “Delete” on page 4‑21.
Get Handlers
Get all handlers associated with the JSL.
Signature
TabularData getHandlers() throws TUXException, JMXConnectionException, SYSException;
Suspend Handler
Change the State of JSH to “SUSpended”.
Input
clientId: Client identifier for JSH.
Signature
void suspendHandler (String clientId) throws TUXException, JMXConnectionException, SYSException;
Resume Handler
Activate a SUSpended JSH object.
Input
clientId: Client identifier for JSH.
Signature
void resumeHandler (String clientId) throws TUXException, JMXConnectionException, SYSException;
Tuxedo Event Broker
MBean Name
“<DOMAINID>_<IPCKEY>:type= tuxedo_event_broker,group_name=<GROUPNAME>,SRVID=<SRVID>”.
Operations
GetParameter
Refer to “GetParameter” on page 4‑20.
GetParameters
Refer to “GetParameters” on page 4‑20.
SetParameter
Refer to “SetParameter” on page 4‑20.
SetParameters
Refer to “SetParameters” on page 4‑21.
Delete
Refer to “Delete” on page 4‑21.
Tuxedo Queue Server
MBean Name
“<DOMAINID>_<IPCKEY>:type= tuxedo_queue_server,group_name=<GROUPNAME>,SRVID=<SRVID>”.
Operations
GetParameter
Refer to “GetParameter” on page 4‑20.
GetParameters
Refer to “GetParameters” on page 4‑20.
SetParameter
Refer to “SetParameter” on page 4‑20.
SetParameters
Refer to “SetParameters” on page 4‑21.
Delete
Refer to “Delete” on page 4‑21.
Tuxedo QTMQ Server
MBean Name
“<DOMAINID>_<IPCKEY>:type= tuxedo_OTMQ_server,group_name=<GROUPNAME>,SRVID=<SRVID>”.
Operations
GetParameter
Refer to “GetParameter” on page 4‑20.
GetParameters
Refer to “GetParameters” on page 4‑20.
SetParameter
Refer to “SetParameter” on page 4‑20.
SetParameters
Refer to “SetParameters” on page 4‑21.
Delete
Refer to “Delete” on page 4‑21.
Create Queue
Input
 
Signature
Void createQueue(String qname, String qorder, String outoforder, Integer maxRetries, Integer retryDelay, String defaultDeliveryPolicy, String cmd, String defaultExpirationTime, String qType, String primaryQueue, Boolean isPermanentActive, String comfirmStyle) throws TUXException, JMXConnectionException, SYSException, USGException;
Tuxedo ART Batch System Target
MBean Name
“<DOMAINID>_<IPCKEY>:type= tuxedo_batch_system,name=Batch_System”.
Operations
getBatchs
Displays the existing jobs.
Input:
batchName: job name
batchID: job id
batchClass: jobs class
batchOwner: job owner
Output:
 
Job TYPRUN definition
Signature:
TabularData getBatchs(String batchName, Integer batchID, String batchClass, String batchOwner)throws MBeanException
getBatchFiles
Gets job script files under the job repository.
Output:
 
Job TYPRUN definition
Signature:
TabularData getBatchFiles()throws MBeanException
submitBatch
Submits a job
Input:
batchScript: job script file name
batchOwner: job owner
batchEJROption: EJR option
batchShellOption: shell option
batchDBLogin: database connection (MT_DB_LOGIN)
batchMTEnv: environment variables
Output:
 
Job TYPRUN definition
Signature:
TabularData submitBatch(String batchScript, String batchOwner,
String batchEJROption, String batchShellOption,
String batchDBLogin, String batchMTEnv) throws TUXException, SYSException, JMXConnectionException, USGException,
cancelBatch
Cancels job(s)
Input:
Refer to the input of “getBatchs” on page 4‑40.
Output:
 
Signature:
TabularData cancelBatch(String batchName, Integer batchId,
String batchClass, String batchOwner) throws SYSException,
TUXException, JMXConnectionException
purgeBatch
Purges job(s)
Input:
Refer to the input of “getBatchs” on page 4‑40.
Output:
Refer to the output of “cancelBatch” on page 4‑42.
Signature:
TabularData purgeBatch(String batchName, Integer batchId,
String batchClass, String batchOwner) throws SYSException,
TUXException, JMXConnectionException
holdBatch
Holds job(s)
Input:
Refer to the input of “getBatchs” on page 4‑40
Output:
Refer to the output of “cancelBatch” on page 4‑42
Signature:
TabularData holdBatch(String batchName, Integer batchId,
String batchClass, String batchOwner) throws SYSException,
TUXException, JMXConnectionException
releaseBatch
Releases job(s)
Input:
Refer to the input of “getBatchs” on page 4‑40
Output:
Refer to the output of “cancelBatch” on page 4‑42
Signature:
TabularData releaseBatch(String batchName, Integer batchId, String batchClass, String batchOwner) throws SYSException, TUXException, JMXConnectionException
getBatchSysOuts
Gets the job sysout
Input:
batchID: job id
Output:
 
Signature:
TabularData getBatchSysOuts(Integer batchId) throws MBeanException
getGDGFiles
Gets the job GDG file content.
Input:
batchID: job id
filename: GDG file name
Output:
 
Signature:
CompositeData getGDGFiles(String bachID, String fileName) throws MBeanException
 

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.