gwlog(1) — Commands
Digital
NAME
gwlog − maintains ACMSxp transaction manager gateway log files
SYNOPSIS
gwlog
DESCRIPTION
Use the gwlog command to run the utility that maintains transaction manager gateway logs. The gwlog utility runs and displays its prompt:
gwlog>
At the prompt, you can type one of the gwlog commands. The utility allows you to view the contents of a gateway log file and to clean up a log file by removing unresolved transaction records. You can also delete the log.
No flags are defined.
COMMANDS
Abbreviate a command by specifying the minimum number of characters needed to uniquely identify it. For example, de r 123 is a valid delete record command.
delete log
Deletes the gateway log file. Use this command before deleting a server whose gateway log file contains transaction records that are not deleted during normal transaction coordination. After the gateway log file is deleted, you can delete the server.
delete record log_sequence_number
Deletes from the gateway log file a record identified by an internal numeric string log_sequence_number. Used to remove transaction records that are not deleted during normal transaction coordination.
dump
Displays on the default output the contents of the gateway log file.
exit
Terminates execution of gwlog.
help
Displays on the default output a list of valid gwlog commands and arguments.
quit
Terminates execution of gwlog.
set log server-simplename
Opens the gateway log file for server server-simplename. The gwlog utility searches for the file in the following directories (in order):
The directory specified by the ACMS_WORK_DIR environment variable
The current working directory of the operating system account under which the command is issued
If the server already has its file open, the gwlog utility does not open the file. This protects the consistency of the gateway log data. If the command does not open the log file, stop the server and retry the set log command.
show log
Displays on the default output the full path and name of the currently selected gateway log file.
ACMSxp Transaction Manager Gateway
The ACMSxp transaction manager (TM) gateway provides transactional integrity across platforms by managing transaction coordination between the Encina transaction manager (on Digital UNIX and Windows NT platforms) and the DECdtm transaction manager (on OpenVMS Alpha platforms). For example, the gateway allows an ACMSxp application on a Windows NT platform to start a transaction, call an ACMSxp task on an OpenVMS Alpha platform within the context of that transaction, and commit all updates with traditional two-phase commit (all or nothing) semantics.
Task servers participating in calls between Encina and DECdtm transaction managers must be configured to use different TMs. Add environment information to the calling and called task servers - the ACMS_FOREIGN_TM environment variable.
The transaction manager gateway maintains a log file for each server involved in this type of transaction. During normal transaction coordination, the gateway adds transaction records to the log file and deletes these records from the log when the transaction completes. If, however, a server is unavailable during the transaction and does not become available again at some later time, you can manually remove unresolved transaction records from the gateway log file.
EXAMPLE
The following contains a sample gwlog session in which a record is deleted.
% gwlog
gwlog> help
gwlog commands:
delete log
delete record <log_sequence_number>
dump
exit
help
quit
set log <server simplename>
show log
gwlog> set log foo
gwlog> show log
Current gateway log file: /udir/user1/bld/wrk/foo.gwl
gwlog> dump
Record type : BRANCH
LSN : 1728
Gateway tid : d595a8c0-2c4b-11d0-b136-08002b3b6f8b
Local TID : 2
Direction : Outgoing
Trans state : Active
Partner name : /.:/std_acmsxp/acmsxp_vms_std_task_svr
gwlog> delete record 1728
gwlog> dump
gwlog> exit
%
In this example, the user invokes the gwlog utility from the shell prompt, displays help text that summarizes command syntax, selects a gateway log file for the task server foo, verifies that the correct file is open, dumps the log file contents, deletes a specific record, dumps the log file contents to verify that the record is deleted, and exits the utility. No output from the dump command indicates that there are no active records.
RELATED INFORMATION
Commands: acms(1), acmsadmin(1), acmsdbx(1), acmslog(1), stdl(1)
Scripts: acms_create_tpsystem(1), acms_delete_tpsystem(1), acms_set_version(1), acms_start_tpsystem(1)