Axway Gateway: Connectors

Managing .pmq files with the pmqctl command

The pmqctl command is only intended for system administrators, preferably with the supervision of Axway Support.

Introduction

The pmqctl command enables you to manage .pmq files used to buffer data to send to Axway Sentinel. In certain cases you may need to optimize the space allocated for these files. files. This may be necessary if, for example, Sentinel is not fed fast enough or if events are not working. You can also use this command to see if the router queue is full.

The Router process also uses an internal router.pmq file but this is handled internally by the supervisor process.

pmqctl usage

Enter the pmqctl command, without arguments, to display the help text:

Usage:

pmqctl read pathname [[nb_to_read] [nb_per_sync]]

pmqctl enlarge pathname new_size

pmqctl create pathname [size]

pmqctl info pathname

pmqctl list pathname

pmqctl dump pathname

pmqctl enlarge pathname new_size

Use this command to specify the useful data space of the file. You can use the command when Gateway is running.

For example, enter the following command to increase the space to 10 000 000 bytes:

pmqctl enlarge $p_home_dir/run_time/data/tracker.pmq 10000000

The resulting file size will be 10 000 256 bytes (256 bytes of meta-data are added to the file).

pmqctl info pathname

Use this command to print out information about the file. You can use the command when Gateway is running.

Enter:

pmqctl info pathname

Example of output:

--

    signature : a1b2c3d4

version_major : 1

version_minor : 0

       status : 1

   reader_pid : 25945

     sequence : 1001

    sync_seqn : 1000

   read_index : 2450

  write_index : 9852

    end_index : 8000000

--

5 records total, 7401 bytes total

Other commands

The following commands are supplied for diagnostic purposes. Only use them if Axway Support advises you to use them.

pmqctl create pathname [size]

pmqctl read pathname [[nb_to_read] [nb_per_sync]]

pmqctl list pathname

pmqctl dump pathname

Warning: Never run the pmqctl read command against an instance of the tracker.pmq file on a production system as it can destroy data (information is read and removed from the file).

Related topics

About Axway Sentinel

 

Links to documentation set for Axway Gateway 6.17.3:

Related Links