Google Message Security Batch Reference Guide User Manual

Browse online or download User Manual for Software Google Message Security Batch Reference Guide. Google Message Security Batch Reference Guide User Manual

  • Download
  • Add to my manuals
  • Print
  • Page
    / 561
  • Table of contents
  • TROUBLESHOOTING
  • BOOKMARKS
  • Rated. / 5. Based on customer reviews
Page view 0
Message Security
Batch Reference Guide
Google Message Filtering
Google Message Security
Google Message Discovery
Message Security and Discovery for Google Apps Premier Edition
Page view 0
1 2 3 4 5 6 ... 560 561

Summary of Contents

Page 1 - Message Security

Message SecurityBatch Reference Guide• Google Message Filtering• Google Message Security• Google Message Discovery• Message Security and Discovery for

Page 2 - Part number: EEBR_R646_00

Contents 11domainname ...470org (for domains) ...

Page 3

102 Modifyarchive_settings modify -- The archive_settings modify command edits the archive settings for an organization.Message Encryption CommandsPo

Page 4 - Contents

Batch Command Quick Summary 103encryption modify_user -- The encryption modify_user command modifies encryption settings for a user. This is applica

Page 5 - 6 Release 6.19

104 Organizationsmodifyorg -- The modifyorg command modifies an organization’s settings.PMP Passwordspassword force_update -- The password force_upda

Page 6 - Contents 7

Batch Command Quick Summary 105Organization Management CommandsAddaddorg -- The addorg command adds a sub-organization to your organizational hierar

Page 7 - 8 Release 6.19

106 PMP Passwordspassword force_update -- The password force_update command forces a user or all users in an organization to change their passwords w

Page 8 - Contents 9

Batch Command Quick Summary 107Unblockunblockprovuser -- The unblockprovuser command unblocks provisional users who have been blocked from becoming

Page 9 - 10 Release 6.19

108 Traceroutecheckroute -- The checkroute command, or Traceroute Test, traces the network route from the server to the input mail server. This is ap

Page 10 - Contents 11

Batch Command Quick Summary 109user_im_settings display -- The user_im_settings display command displays IM settings for a given user email address.

Page 11 - 12 Release 6.19

Chapter 4 Batch Field Quick Summary 111Batch Field Quick SummaryChapter 4About the Batch Field Quick SummaryThis index is a quick summary mapping fie

Page 12 - About this Book

112 Fields -- Related Commands• qtine_redir_out_atq -- displayorg, modifyorg• qtine_redir_out_virus -- displayorg, modifyorgDefault User FieldsDefaul

Page 13 - Related Documentation

12 Release 6.19 Chapter 10: Batch Spool Fields...521About Batch Spool Fields ...

Page 14 - About Batch Processing

Batch Field Quick Summary 113Fields -- Related Commands• filter_getrich -- adduser, displayuser, modifyuser• Offers SettingsFields -- Related Comman

Page 15 - Batch Processing Steps

114 Substripping• On/OffFields -- Related Commands• substrip -- displaydomain• sub_strip -- Administration Console-Domain Download/SettingsEarly Dete

Page 16

Batch Field Quick Summary 115Fields -- Related Commands• quota -- displayspool• Time before spoolingFields -- Related Commands• spool_delay -- displ

Page 17 - Batch Commands Syntax

116 Fields -- Related Commands• orgname -- iplock displayMessage Encryption (See User, General Setting Fields)• External On/Off MatchFields -- Relate

Page 18 - Building a Batch File

Batch Field Quick Summary 117Fields -- Related Commands• authentication_type -- displayorg• EZCommand secretFields -- Related Commands• remotecmd_se

Page 19

118 Fields -- Related Commands• support_contact -- displayorg, modifyorg• Account IDFields -- Related Commands• customerid -- getorgreport• Creator o

Page 20

Batch Field Quick Summary 119Fields -- Related Commands• im_enable -- modifyorg, org_im_settings modify, displayorg, org_im_settings displayFields -

Page 21 - About EZCommand

120 Message Limits Fields (for Orgs)Inbound• Attachment SizeFields -- Related Commands• max_message_size -- displayorg, modifyorg• Msg. Limit (per da

Page 22 - Calling EZCommand

Batch Field Quick Summary 121Notifications Fields (for Orgs)Notifications• On/OffFields -- Related Commands• disable_first_spam -- displayorg, modif

Page 23 - EZCommand Reference

122 Reports, Spam FieldsInbound• NameFields -- Related Commands• account -- getorgreport• Quarantined messages from Blocked Senders listFields -- Rel

Page 24

Chapter 1 Introduction to Batch Processing 13Introduction to Batch ProcessingChapter 1About this BookWelcome to the Batch Reference Guide for Message

Page 25 - Troubleshooting: Batch

Batch Field Quick Summary 123Fields -- Related Commands• naughty -- getorgreport• Total spam in quarantine in bytesFields -- Related Commands• bytes

Page 26 - Chapter 2

124 Fields -- Related Commands• num_messages -- getorgreport• Total of mail going to accountsFields -- Related Commands• acc_messages -- getorgreport

Page 27

Batch Field Quick Summary 125Fields -- Related Commands• sellerid -- getorgreport• Total messagesFields -- Related Commands• messages -- getorgrepor

Page 28

126 Fields -- Related Commands• bytes -- getorgreportSender List Fields (for Orgs)Approved Senders• Addresses, domainsFields -- Related Commands• app

Page 29

Batch Field Quick Summary 127Blocked• Addresses, domainsFields -- Related Commands• blocked_senders (for users) -- adduser, modifyuser, displayuserS

Page 30

128 Fields -- Related Commands• filter_adult -- adduser, modifyuser, displayuser• filter_bulk -- adduser, modifyuser, displayuser• filter_getrich --

Page 31

Batch Field Quick Summary 129User, Access Fields (for Orgs)Message Center• On/OffFields -- Related Commands• quarantine_links -- displayorg, modifyo

Page 32

130 Fields -- Related Commands• lang_locale (for orgs) -- displayorg, modifyorg• NDRFields -- Related Commands• ndr -- displayorg, modifyorg• nullsen

Page 33

Batch Field Quick Summary 131Fields -- Related Commands• address -- adduser, modifyuser, displayuser (For more cmds, see address page)• Name, IDFiel

Page 34

132 Fields -- Related Commands• TS1 -- listprovusersTime/Language• Creation timestampFields -- Related Commands• created_ts (for users) -- listdomain

Page 35

14 The Message Security service Customer Care does not provide technical support for configuring mail servers or third-party products. In the event o

Page 36

Batch Field Quick Summary 133Fields -- Related Commands• address -- suspenduser• User alaisFields -- Related Commands• address -- addalias, deleteal

Page 37

134 Fields -- Related Commands• virus_clean -- displayorg, modifyorg• Redirect addressFields -- Related Commands• qtine_redir_virus -- displayorg, mo

Page 38

Chapter 5 Batch Commands 135Batch CommandsChapter 5About Batch CommandsThe batch commands let you automate the management of large organizational con

Page 39

136 See “Batch Command and Field Quick Summary” on page 27 for an overall syntax summary, and see “Batch Command Quick Summary” on page 91 for more i

Page 40

Batch Commands 137addaliasThe addalias command associates an additional address with a user’s primary email address. The alias receives the same fil

Page 41

138 If <alias> is an existing alias for another user, the alias will be transferred to the new <user address>. If <alias> is an exi

Page 42

Batch Commands 139‘No arguments supplied’‘No domain record exists for targetalias. Please add the domain first and then add aliases.’‘Invalid addres

Page 43

140 listusers ALL, [email protected], targetOrg=100046262, childorgs=1, aliases=1listusers [email protected], targetOrg=200046262, ch

Page 44

Batch Commands 141Exampleadddomain sales, domain=jumboinc.comadddomain “Jumbo’s Western Region”, domain=jumboinc.comDescriptionAdds the domain recor

Page 45

142 Notes• Confirm the domain is already associated with an email config. If not, add the domain to the email config.• A domain must be added below i

Page 46 - MX Record Test

Introduction to Batch Processing 15About Batch ProcessingThe standard batch processing is a quick and efficient method to perform a large number of

Page 47

Batch Commands 143DescriptionCreates a new organization, <org name>, underneath the parent organization, <parent org>. • <org name>

Page 48 - Domain Fields

144 Related CommandsBatch Commands: deleteorg, displayorg, getorgreport, listorgs, modifyorg, org_im_settings display, org_im_settings modify, setorg

Page 49

Batch Commands 145ExampleBatch command interface examples:• Add a user, add to the user’s approved_senders list, and send out an immediate welcome n

Page 50

146 adduser [email protected] to adduser%20msmith%40jumboinc.comWARNING: Do not add a distribution list or a mailing list as a user account

Page 51 - Organization Fields

Batch Commands 147‘Created new user [email protected] in organization Finance.’• When used as an EZCommand, the HTTP response will contain a two-p

Page 52

148 Related: active, address, approved_senders (for users), approved_recipients, blocked_senders (for users), message_encrypt (for users), message_en

Page 53

Batch Commands 149If your archive feature is not enabled, this error message is returned:archive_settings display error: select * from archive_confi

Page 54

150 Related Fields• Input: orgname• Related: archive, archive_enable, custom_journal, retention_months, standard_journalSee Also“Building a Batch Fil

Page 55

Batch Commands 151DescriptionArchive settings can only be made on a user org (not account or email config orgs). • org -- The name of the organizati

Page 56

152 Related Fields• Input: orgname• Related: archive, archive_enable, custom_journal, retention_months, standard_journalSee Also“Building a Batch Fil

Page 57

16 Batch ValidationIn the Administration Console’s Batch page, the batch validator checks either a batch file or batch commands typed in to the batch

Page 58

Batch Commands 153ClassificationBatch user managementNotes• Do this for users you don’t want to provide Message Security for, or for a user who has

Page 59

154 Syntaxchecklatency <email config org>, mailhost=<mail server>Examplechecklatency sales email config, mailhost=my.mailserver.comDescri

Page 60

Batch Commands 155Notes• Use the Latency Test if you want to see how well the network is responding. The test results are relative and must be compa

Page 61

156 Examplecheckroute salesemailconfig, mailhost=mailserver.jumboinc.comDescriptionTraces the connection from the server to the input mail server, &l

Page 62

Batch Commands 157Notes• When a firewall blocks a traceroute test, this may take a few minutes.• Some service providers prevent traceroutes.• Tracer

Page 63

158 DescriptionBatch Interface Description for deletealiasDeletes the alias address, <alias>.• <alias> -- The user alias being deleted.En

Page 64

Batch Commands 159Return Values• Batch command interface return values:• If the [email protected] user alias was deleted, this string is returne

Page 65

160 The Message Security Administration Guide, “Users and Quarantines”deletedomainThe deletedomain command removes the domain from your organizationa

Page 66

Batch Commands 161Notes• Remove all users in this domain before removing the domain.• Edit the domain’s DNS MX entries to the Message Security serv

Page 67 - Canada); Tijuana)

162 DescriptionDeletes the organization identified by the <org name>.• <org name> -- The organization being deleted.Enclose <org name&

Page 68

Introduction to Batch Processing 172. Create and enter your batch commands by either of the following methods:If you need to work with several batch

Page 69 - Report Fields

Batch Commands 163Related CommandsBatch Commands: addorg, displayorg, getorgreport, listorgs, modifyorg, org_im_settings display, org_im_settings mo

Page 70

164 Authorization• Read: Delete Users• Write: Delete UsersClassificationBatch user managementNotes• Used with SmartCreate, newly added users are unco

Page 71

Batch Commands 165Syntaxdeleteuser <user address | u_id> [ , deactivate] [ , purge] [ , confirm ]Exampledeleteuser [email protected] the u

Page 72

166 Enclose <user address> in double quotes or preceded with a ‘\’ symbol if it contains a quote (‘), double quote (“), backslash (\), apostrop

Page 73

Batch Commands 167‘No such user ‘username’ (unknown administrator address supplied).’‘String authorization failed.’‘No commands to process.’‘Command

Page 74

168 Notes• When using the batch commandline interface, remove an administrator’s record before removing the administrator’s user record. See the conf

Page 75

Batch Commands 169DescriptionDisplays the domain settings for the <domain name><domain name> -- The domain being displayed.Return Values

Page 76

170 Related Fields• Input: domainid, domainname• Output: alias, aliasedfrom, aliasedto, org (orgname), substrip• Related: domainid, domainname, iid,

Page 77 - Spool Fields

Batch Commands 171antivirus_sensitivity 0 (normal),approved_senders empty,archive 1 (on),async_bounce NULL (),at_notify_on NULL (),authentication_da

Page 78

172 virus_clean 1 (on),virus_notify 0 (Immediately),welcome_on 1 (on)zero_hour_notify_on 0 (off)zero_hour_scan 0 (off)Authorization• Read: Organizati

Page 79 - User Fields

18 This process code ensures that batch files are not submitted by inadvertently clicking Submit job instead of Validate. If you do not enter the pro

Page 80

Batch Commands 173parent_org, qsum_actionable, qsum_enable, qtine_redir_atq, qtine_redir_ndr, qtine_redir_out_atq, qtine_redir_out_virus, qtine_redi

Page 81

174 DescriptionDisplays a provisional user address and the last time an email was received. The time is in UNIX seconds.Enclose <user address>

Page 82

Batch Commands 175Related Fields• Input: address• Output: iid, TS1, TS3See Also“Building a Batch File” on page 19“Editing Your Mail Handling Policie

Page 83

176 Enclose <org name> in double quotes or preceded with a ‘\’ symbol if it contains a quote (‘), double quote (“), backslash (\), apostrophe,

Page 84

Batch Commands 177Notes• If within one minute three connection attempts to your mail server fail, Spool Manager starts the spool delay period which

Page 85

178 displayuserThe displayuser command shows all the user’s settings information.Syntaxdisplayuser <user address | user_id>Exampledisplayuser m

Page 86 - TS3 1145962000

Batch Commands 179timezone NULL,user_id 202846402,virus_notify NULL (),virus_state 0 (on),weblocked 0 (no),welcome_count 1,wireless_state 1 (off)Aut

Page 87

180 “Message Center Settings and Password Examples” on page 536“Viewing Your Organization’s Sender Lists” on page 554“Viewing Message Center Settings

Page 88

Batch Commands 181DescriptionAdds Policy-Enforced TLS for orgs that need to identify domains that need inbound or outbound message traffic (ib_sende

Page 89 - Batch Command Quick Summary

182 Related CommandsBatch Commands: domain_tls delete, domain_tls display, domain_tls modifyRelated Fieldsmessage_encryption (for orgs)See Also“Build

Page 90 - Add Commands

Introduction to Batch Processing 19Following are the batch command syntax tokens:•batch-command -- The name of the batch command to process.•1st-arg

Page 91 - Delete Commands

Batch Commands 183DescriptionDeletes an organization’s Policy-Enforced TLS settings. This command is run at the email config-level.• orgtag -- Org n

Page 92 - IP limitations

184 Related CommandsBatch Commands: domain_tls add, domain_tls display, domain_tls modifyRelated Fieldsmessage_encryption (for orgs)See Also“Building

Page 93 - Display and Report Commands

Batch Commands 185DescriptionDisplays an organization’s Transport Layer Security (TLS) settings. This command is run at the email config-level.• org

Page 94

186 Authorization• Read: Organization Management, Inbound Transport Security if using inbound or Outbound Transport Security if using outbound.• Writ

Page 95 - Domain Management Commands

Batch Commands 187Exampledomain_tls modify org=Salesemailconfig, hop=ib_sender, domain=_default, cert_validation=verifyDescriptionEdits Policy-Enfor

Page 96 - IM Security Commands

188 Related CommandsBatch Commands: domain_tls add, domain_tls delete, domain_tls displayRelated FieldsInput: orgname, domainnameSee Also“Building a

Page 97

Batch Commands 189ext_encryptroute_idout_tls_source_flagsout_tls_recipient_flagsin_tls_flagsAuthorization• Read: Message Encryption Management, Outb

Page 98 - List Commands

190 encryption display_userThe encryption display_user command displays user specific encryption information. This command applies to Postini Message

Page 99

Batch Commands 191Notes• The ext_encrypt_criteria and ext_encrypt are the message_encryption (for orgs), message_encryption_criteria fields.• In add

Page 100 - Message Encryption Commands

192 DescriptionLists all encryption users in this organization.Enclose <user address> in double quotes or preceded with a ‘\’ symbol if it cont

Page 101 - Modify Commands

20 This example uses the ‘Sales’ organization which has two domains, ‘@sales.jumboinc.com’ and ‘@support.jumboinc.com’. It returns all of the users w

Page 102 - Notification Commands

Batch Commands 193See Also“Building a Batch File” on page 19Postini Encryption Services Administration Guideencryption modify_orgThe encryption modi

Page 103

194 DescriptionModifies the encryption settings for an organization.• <org name> -- The organization being modified.Note: Enclose <org name&

Page 104 - PMP Passwords

Batch Commands 195Billing only applies to organization and individual user external encryption settings. Content Manager encryption rules are not in

Page 105 - Test Commands

196 Exampleencryption modify_user, [email protected], service=onDescriptionModifies the encryption settings for a user.• ‘service=on’ -- En

Page 106 - User Management Commands

Batch Commands 197Billing only applies to organization and individual user external encryption settings. Content Manager encryption rules are not in

Page 107

198 getorgreport sales, report=spam_summary, date=20060331getorgreport sales, report=usage_summary, date=20060331getorgreport sales, report=spam_summ

Page 108 - Batch Field Quick Summary

Batch Commands 199Errors• If using the Administration Console, verify the organization exists. Or verify the command punctuation (‘,’) is correct:•

Page 109 - Default User Fields

200 inf_deliveries 0,num_viruses 6SpamSpam Report returns these comma delimited fields for each user’s report in the list.account Jumbo Inc,bad_isp 0

Page 110 - IDs and Name

Batch Commands 201Notes• In addition when using a batch file, comments begin with a ‘#’ hash symbol. If not on a separate line, the hash symbol coul

Page 111 - Email Config Fields

202 racial -- Racially Insensitivedeliveries -- Deliverd from Quarantinebulk -- Bulk MailUsageUsage report fields -- Batch page field labelscustomeri

Page 112 - IP Locking

2 Message Security Batch Reference Guide Google, Inc.1600 Amphitheatre ParkwayMountain View, CA 94043www.google.comPart number: EEBR_R646_0029 Februa

Page 113 - General Org Settings Fields

Introduction to Batch Processing 218. You can now validate this file and upload it as a batch file as described in “Batch Processing Steps” on page

Page 114 - People/Support

Batch Commands 203Syntaxhelp <command>Examplehelp displayorgDescriptionDisplays syntax, example, and quick tips for a command.ErrorsAlways tes

Page 115 - IM Security Fields (for Orgs)

204 iplock add_rangeThe iplock add_range command allows emails from specific domains with specific IP addresses to be delivered to an organization an

Page 116 - Message Archiving

Batch Commands 205If junk email messages are reaching your users because the sender is falsifying a domain name in your Approved Senders list, and i

Page 117 - Outbound

206 For more information about CIDR notation, see RFC 1518, 1519, and 4632 at the Internet Engineering Task Force (IETF) RFC page. In addition, the I

Page 118 - Quarantine Summary

Batch Commands 207Command: iplock add_range org=_email_config , domain=jumboinc.com, range=64.18.0.0/16Returns: Added jumboinc.com as allowed for 64

Page 119 - Reports, Spam Fields

208 See Also“Building a Batch File” on page 19The Message Security Administration Guide, “IP Ranges and Security”, and “Avoid Spoofing”iplock deleteT

Page 120 - Reports, Traffic Fields

Batch Commands 209WARNING: The <IP address> is necessary for the command to be processed, however, all entries of this domain are deleted. Any

Page 121 - Reports, Usage Fields

210 iplock delete_rangeThe iplock delete_range command removes either one IP limitation or all IP limitations for one domain configured in the specif

Page 122 - Reports, Virus Fields

Batch Commands 211Enclose <org name> in double quotes or preceded with a ‘\’ symbol if it contains a quote (‘), double quote (“), backslash (\

Page 123 - Sender List Fields (for Orgs)

212 Notes• The iplock delete_range command clears the one or all IP locks for a specfic domain. The iplock delete_range command deletes all IP locks

Page 124

22 About EZCommandEZCommand is a Perl-based scripting interface that allows administrators to perform basic tasks without having to log in to the Adm

Page 125 - System Testing Fields

Batch Commands 213Exampleiplock display org=sales_email_configDescriptionThe iplock display batch command lists all domain and associated IP address

Page 126 - Quarantine summary

214 Notes• If an email config organization is converted to a user organization, the IP locks for any domain associated with the email config is delet

Page 127 - User, General Setting Fields

Batch Commands 215ExampleThe default behavior is to reject with a 550 error any message that does not match the IP range:iplock set_disposition org=

Page 128 - Provisional User

216 Notes• The iplock set_disposition command is not available in this version. The default behavior is to ‘reject’ a message that does not match a l

Page 129 - User management

Batch Commands 217Example• Batch command interface examples:• List all domains starting with the sales org, and sort the results by org name in ASCI

Page 130 - Wireless Forwarding

218 qstringThe qstring rules are:• If the target text starts with ‘=’, the result must be an exact match. For example, =jumboinc.com returns exact ma

Page 131

Batch Commands 219aliasesThe aliases parameter values are:‘aliases=0’ -- Do not include domain aliases in the search results.‘aliases=1’ -- Include

Page 132 - Batch Commands

220 fieldsThe fields parameter is a list of field data displayed in the search results. These are separated by ‘ | ‘.• All of the sortable fields can

Page 133

Batch Commands 221Authorization• Read: Edit Organizations• Write: Edit OrganizationsNote: The qstring filtering requires at least one All Standard P

Page 134 - Description

222 Syntaxlistorgs <orgtag gstring | ALL>[ , targetOrg=<org name> ] [ , childorgs=<0/No | 1/Yes> ] [ , sort=<sortspec> ] [ ,

Page 135

Introduction to Batch Processing 23Note: You can create or modify this shared secret using the modifyorg command and the remotecmd_secret field. For

Page 136 - Classification

Batch Commands 223orgtag qstringThe ‘orgtag qstring’ is the organization you are searching for. This is the target text matched to the search result

Page 137 - See Also

224 Sortable fields include:• ORGTAG• IIDSort order include:• a = ASCII ascending• d = ASCII descending• na = numeric ascending• nd = numeric descend

Page 138 - Batch Commands 141

Batch Commands 225Return values using Administration Console syntax:100001011 sales1 of a total of 1 matching records found.• Return values are depe

Page 139

226 Related CommandsBatch Commands: addorg, deleteorg, displayorg, getorgreport, modifyorg, org_im_settings display, org_im_settings modify, setorgsu

Page 140 - JumboInc

Batch Commands 227Examplelistprovusers My Company, subset=ALL, sort=TS1:d, fields=ADDRESS|TS1|TS3DescriptionDisplays information about a set of prov

Page 141

228 The match specifications include:• If the target text starts with ‘=’, the result must be an exact match. For example, [email protected] retur

Page 142

Batch Commands 229fieldsThe fields parameter is a list of fields to display in results, separated by ‘ | ’.Note: This is limited to sortable fields.

Page 143

230 Notes• If your account has the SmartCreate feature enabled, users in your domains whose address ends in @yourdomain, will be added automatically

Page 144

Batch Commands 231[, sort=<sortspec>] [, fields=<fieldlist>][, start=<startindex>] [, end=<endindex>][, type_of_user=<im

Page 145

232 address qstringAn address qstring parameter is the partial or full user’s email address. This is the target text to match with the search results

Page 146

24 EZCommand Response CodesThe HTTP response will contain a two-part return value: <status> <message>• status: 1 for success or 0 for fai

Page 147

Batch Commands 233aliasesThe aliases parameter includes:• aliases=0 -- Don’t include user aliases in the search results.• aliases=1 -- Include user

Page 148

234 To list all users starting with the Sales organization, and including whether the user is active, how the user was created and the date of creati

Page 149

Batch Commands [email protected] sales1 of a total of 1 matching records found.• Return values are dependent upon the command’s parameter optio

Page 150

236 Related Fields• Input: active, address, create_method (for users), created_ts (for users), orgname, orgtag, primary_add, timezone (for users), u_

Page 151

Batch Commands 237modifydomain jumboinc.com, alias=jumboalias.com• To delete jumboalias.com domain alias and add another:modifydomain jumboinc.com,

Page 152

238 ‘Moved domain western.sales.jumboinc.com from Sales to WestCoastSales.’Authorization• Read: Edit Organizations• Write: Edit OrganizationsClassifi

Page 153

Batch Commands 239Examplemodifyorg sales, [email protected], max_message_size=250modifyorg sales, im_enable=onDescriptionMod

Page 154 - Batch Commands 157

240 Whenever the shared secret is changed in the scripts, it should also be changed in the authentication_data field for the org which contains the u

Page 155

Batch Commands 241“Viewing Message Center Settings” on page 536“Viewing and Editing Message Encryption Settings” on page 565“Setting a Virus Notific

Page 156 - Batch Commands 159

242 EZCommand Description for modifyuserSee the Batch Interface Description for modifyuser for general usage details.• When used as an EZCommand, the

Page 157

Introduction to Batch Processing 25https://ac-s<N>.postini.com/exec/remotecmd?auth=<authstring>&cmd=adduser%20agoodman%40jumboinc.co

Page 158 - Batch Commands 161

Batch Commands 243‘Modified [email protected]: Set filter_getrich to moderate. Set filter_adult to 13.’• When used as an EZCommand, the HTTP respo

Page 159 - ‘Deleted organization Sales.’

244 Related FieldsInput: active, address, approved_senders (for users), approved_recipients, blocked_senders (for users), message_encrypt (for users)

Page 160 - Batch Commands 163

Batch Commands 245DescriptionDisplays an organization’s notification attributes depending on the notification typeNotification type descriptions:• a

Page 161

246 notification display type=allattachment_manager_inbound notification settings:state=offtext=defaultattachment_manager_outbound notification setti

Page 162

Batch Commands 247notification display type=early_detection_quarantinestate=offtext=defaultnotification display type=first_spamcc=nonestate=ontext=d

Page 163

248 Authorization• Read: Notification Messages, Edit Organizations (as a general rule)• Write: Notification Messages, Edit Organizations (as a genera

Page 164

Batch Commands 249notification modify type=password_reset, org=<org name> [ , text=link:<the org which shares the notification text> | u

Page 165

250 Notification type descriptions:• attachment_manager_inbound -- Notification sent when an attachment arrives on inbound mail. This is only used wi

Page 166

Batch Commands 251Note: If an organization does not have the notification’s feature, an “Invalid notification type.” error is returned.• first_spam

Page 167

252 unlinking shared notifications, the designated org keeps a copy of the notification, but it can not be updated by the other sharing org. This is

Page 168 - Batch Commands 171

26 modifyuserSyntax:modifyuser username [field=value]... suspenduserSyntax:suspenduser username [notify] [hardSuspend] [deliver] •suspend: All filter

Page 169

Batch Commands 253Authorization• Read: Notification Messages, Edit Organizations (as a general rule)• Write: Notification Messages, Edit Organizatio

Page 170

254 DescriptionDisplays an im settings record for a given org:• orgtag -- Name of the organization whose IM settings are being displayed.Enclose <

Page 171 - TS3: 1141429660

Batch Commands 255Related CommandsBatch Commands: iplock add_range, im display, im list, im listforuser, listusers, modifyorg, user_im_settings add,

Page 172

256 DescriptionModifies an the organization im settings record for a given orgtag:• orgtag -- The organization nameEnclose <org name> or <us

Page 173

Batch Commands 257Notes• The file transfer controls affect Yahoo!, AIM, and MSN. At this time, Google Talk transfers are blocked by default.• In add

Page 174

258 Example• To force an individual user to change a password:password force_update [email protected]• To force all users in an organization t

Page 175

Batch Commands 259NotesWhen using a batch file, comments begin with a ‘#’ hash symbol. If not on a separate line, the hash symbol could be interpret

Page 176 - Batch Commands 179

260 password reset [email protected], password=a8f2KTT*#, notify=yesDescriptionResets a PMP user’s password. • If a user and a clear text pass

Page 177

Batch Commands 261Related FieldsInput: addressSee Also“Building a Batch File” on page 19The Message Security Administration Guide, “User Authenticat

Page 178

262 This org does not have the appropriate feature authorization.If you have the wrong authorization privileges:You do not have the proper authorizat

Page 179

Chapter 2 Batch Command and Field Quick Summary 27Batch Command and Field Quick SummaryChapter 2About the Batch Command and Field Quick SummaryThis i

Page 180

Batch Commands 263Related CommandsBatch Commands: password force_update, password reset, password_policy updateRelated FieldsInput: orgnameSee Also“

Page 181

264 Example• The basic setting recommendation is for min_length=6 and required_complexity=yes. The remaining parameters should match your company’s p

Page 182

Batch Commands 265DescriptionUpdates the password policy for an existing organization, including sub-organizations if cascade is enabled. If a PMP p

Page 183

266 Default: max_password_age=null• ‘cascade=no’ -- Sub organization passwords will not be updated with new changes.• ‘cascade=yes’ -- Sub organizati

Page 184

Batch Commands 267Related CommandsBatch Commands: password force_update, password reset, password_policy displayRelated FieldsInput: orgnameSee Also

Page 185

268 Authorization• Read: Add Users• Write: Add UsersClassificationBatch user managementNotes• Used with SmartCreate, newly added users are unconfirme

Page 186 - Batch Commands 189

Batch Commands 269Syntaxresetuser <user address>Exampleresetuser [email protected] most user fields for <user address>

Page 187

270 Related CommandsBatch Commands: modifyuser, suspenduserRelated FieldsInput: addressSee Also“Building a Batch File” on page 19“Resetting Users” on

Page 188 - Batch Commands 191

Batch Commands 271Errors“Please supply a valid sub-stripping value (0 or 1)” -- Do not use ‘on’ or ‘off’ with this command.Return ValuesIf the sales

Page 189

272 Related Fields• Input: orgname, iid• Related: substripSee Also“Building a Batch File” on page 19The Message Security Administration Guide, “Domai

Page 190

28 Batch CommandsaddaliasThe addalias command associates an additional address with a user’s primary email address. The alias receives the same filte

Page 191

Batch Commands 273Return ValuesNo Locked Domain:IP addressesNo ip / domain mappings present.Locked Domain:IP addressesdomain.com -> 64.19.7.234/1

Page 192

274 suspenduserThe suspenduser command suspends a user by disabling all filtering and the user’s access to the Message Center.Syntaxsuspenduser <u

Page 193

Batch Commands 275This is a positional parameter and is optional. If used, the parameter must be at the end of the command. There is no numeric equi

Page 194

276 status -- 1 for success or 0 for failuremessage -- Contains errors and additional detailsAuthorizationWrite: Help DeskClassificationBatch user ma

Page 195

Batch Commands 277testfirewallThe testfirewall command tests whether your firewall allows email traffic from IP addresses outside of the Message Sec

Page 196

278 ClassificationBatch test managementNotes• Malicious senders may attempt to send traffic directly to port 25 on your server, and bypass filtering

Page 197

Batch Commands 279Syntaxtestmail <user address>, mailtype=<1 | 0>Exampletestmail [email protected], mailtype=1DescriptionSends a test

Page 198 - Batch Commands 201

280 HELO failed.• SMTP Connection failed -- See The Message Security Administration Guide, “Troubleshooting Incoming Email Delivery” for full steps.•

Page 199

Batch Commands 281Sending RECPT TOSending dataEnd of data dotSuccessThe email data center can deliver email to this email server.In all 3 cases the

Page 200 - Displayorg

282 Syntaxtestmx <domain name>Exampletestmx mailserver.jumboinc.comDescriptionChecks the mail exchange record of the input domain, <domain n

Page 201 - Examples

Batch Command and Field Quick Summary 29This is applicable to the Google Message Security, Google Message Discovery, and Google Message Filtering pr

Page 202 - Batch Commands 205

Batch Commands 283orMultiple MX records found containing ‘sNbM.psmtp.com’ -- Remove the duplicate entry listed.• Unable to resolve ‘jumboinc.com’ --

Page 203

284 Related FieldsInput: domainnameSee Also“Building a Batch File” on page 19The Message Security Administration Guide, “Test Tools & Mail Flow T

Page 204

Batch Commands 285ClassificationBatch user managementNotes• Used with SmartCreate, newly added users are unconfirmed provisional users. These users

Page 205

286 Syntaxuser_im_settings add address=<user address>, external_enable=<on | off>, proto_enable=< + | - >all | aim | msn | yahoo |

Page 206 - Batch Commands 209

Batch Commands 287Authorization• Read: IM Management• Write: IM ManagementClassificationBatch IM user managementNotesIn addition when using a batch

Page 207

288 Exampleuser_im_settings delete [email protected] an user im settings record for a given user address.• address -- Ema

Page 208

Batch Commands 289Related CommandsBatch Commands: iplock add_range, im delete, im display, im list, im listforuser, listusers, modifyorg, user_im_se

Page 209

290 ErrorsPossible errors include:“You don’t have Instant Messenger feature.”“Please enter the address to display the user im settings record.”“Canno

Page 210

Batch Commands 291Related Fields• Input: address• Output: address, file_transfer_receive, file_transfer_send, im_external_enable, im_proto_enable, u

Page 211

292 Note: Enclose <user address> in double quotes or preceded with a ‘\’ symbol if it contains a quote (‘), double quote (“), backslash (\), ap

Page 212

30 checklatencyThe checklatency command measures the connection delay between the email data center and your email server. This is the Latency Test.T

Page 213

Batch Commands 293Notes• New IM record values are inherited from the user’s org im settings.• In addition when using a batch file, comments begin wi

Page 214

Chapter 6 Batch Organization Fields 303Batch Organization FieldsChapter 6About Batch Organization FieldsThe batch organization fields hold org-level

Page 215

304 The reference pages use the Administration Console syntax and have an example for each field:• The field name is required. In the Administration

Page 216 - Batch Commands 219

Batch Organization Fields 305modifyorg sales, antivirus_sensitivity=16DescriptionFlag indicating whether virus cleaning is allowed for this organiza

Page 217

306 approved_senders (for orgs)The approved_senders field holds an email address or domain to be added or removed from the organization-level Approve

Page 218 - Batch Commands 221

Batch Organization Fields 307Field TypeOrg-levelAuthorization• Read: Junk Email• Write: Junk EmailNotes• Mail from senders on this list will bypass

Page 219

308 See Also“Viewing Your Organization’s Sender Lists” on page 554“Adding Users and Domains to Sender Lists” on page 555“Viewing Message Center Setti

Page 220 - Batch Commands 223

Batch Organization Fields 309Authorization• Read: Edit organizations• Write: Edit organizationsNotesThe archive field is the same value as the archi

Page 221

310 archive_enable NULL• To change the setting:archive_settings modify org=Jumbo ABC, archive_enable=on, mail_flow=on, journaling=onDescriptionLists

Page 222

Batch Organization Fields 311See AlsoEditing Message Archiving SettingsPostini Message Archiving Administration Guideasync_bounceThe async_bounce fi

Page 223

3This software is provided “AS IS.” The copyright holders disclaim all warranties, either express or implied, including but not limited to implied w

Page 224

Batch Command and Field Quick Summary 31This is applicable to the Google Message Security, Google Message Discovery, and Google Message Filtering pr

Page 225

312 Authorization• Read: Auto Connection Manager• Write: Auto Connection ManagerNotesWhen activating this service, it is important to keep your user

Page 226

Batch Organization Fields 313modifyorg sales, at_notify_on=1DescriptionNotification sent to recipient of Inbound Attachment Manager notifications:•

Page 227

314 See AlsoThe Message Security Administration Guide, “Quarantine Summary & Notifications”authentication_dataThe authentication_data field holds

Page 228

Batch Organization Fields 315DescriptionString holding the text that is used to validate users in a non-PMP authenticated organization which are eit

Page 229 - [email protected]

316 NotesPOP authentication is the only authentication method compatible with the blatant_spam field.Related Commands• Output: displayorg• Input: add

Page 230 - Batch Commands 233

Batch Organization Fields 317DescriptionDefines the type of authentication used by an organization:• 1 = Privately Managed Passwords, (PMP)• 4 = POP

Page 231

318 autocreate_webThe autocreate_web field determines whether users can be automtically created when the organization is using POP authentication. Th

Page 232

Batch Organization Fields 319Notes• Applies only if the organization has associated domains.• Web Autocreate works only for orgs that use POP Authen

Page 233

320 DescriptionTurns OFF, deletes <blackhole>, or bounces <ERROR 571 Message Refused> the most obvious spam before it reaches the email s

Page 234

Batch Organization Fields 321blocked_senders (for orgs)The blocked_senders field lists an email address or a domain to be added or removed from the

Page 235 - WestCoastSales.’

32 displaydomainThe displaydomain command displays all of the selected domain’s settings information.Batch Command Syntax and Example:displaydomain &

Page 236 - Batch Commands 239

322 Authorization• Read: Junk Email• Write: Junk Email Notes• Entries apply to all users in the organization, but are not visible to the organization

Page 237

Batch Organization Fields 323“Adding Users and Domains to Sender Lists” on page 555“Viewing Message Center Settings” on page 536The Message Security

Page 238

324 Related Commands• Output: displayorg• Input: addorg, modifyorgSee AlsoThe Message Security Administration Guide, “Organization Management”company

Page 239

Batch Organization Fields 325Related Commands• Output: displayorg• Input: modifyorgSee Also“Viewing Authentication and Password Settings” on page 54

Page 240

326 Notes• This field only applies to deployments of Perimeter Manager Enterprise Edition, Release 5.0 and later. This includes Message Security for

Page 241

Batch Organization Fields 327Field TypeOrg-levelAuthorization• Read: Edit Organizations• Write: Read-only for administrators.NotesThis field only ap

Page 242

328 creator 202781130 ([email protected])DescriptionThe creator field lists the user ID and address of the administrator who created the organizati

Page 243

Batch Organization Fields 329Examples• When the field is returned as output:custom_journal on• To change the setting:org_im_settings modify orgtag=s

Page 244 - Batch Commands 247

330 Related Commands• Input: org_im_settings modify• Output: org_im_settings displayRelated Fieldsarchive, standard_journalSee Also“Editing Message A

Page 245

Batch Organization Fields 331Field TypeOrg-levelAuthorization• Read: Traffic Limits• Write: Traffic LimitsNotes• When exceeded, incoming messages ar

Page 246

Batch Command and Field Quick Summary 33displayspool <email config org>displayspool jumboemailconfigdisplayuserThe displayuser command shows a

Page 247

332 default_userThe default_user field lists the name of the organization’s Default User template used when creating a new user in this org.Syntaxdef

Page 248 - Batch Commands 251

Batch Organization Fields 333Notes• Every org containing users must have a Default User.• You can create additional Default Users, give them unique

Page 249

334 DescriptionSwitch for first spam notification. • 1/off -- The first spam notification will be sent to users in this organization. This is the def

Page 250 - Batch Commands 253

Batch Organization Fields 335disposition_virusThe disposition_virus field holds the disposition status of an email containing a virus. The dispositi

Page 251

336 NotesWhen a virus is detected, the Message Security service inserts the X-pstnvirus header to show what virus was caught. The format of the head

Page 252

Batch Organization Fields 337Related Fieldsantivirus_sensitivity, non_account_virus_scan, timezone (for orgs), virus_clean, virus_notify (for orgs)S

Page 253

338 Description• Enables IM file transfers internally and externally. The file transfer controls affect Yahoo!, AIM, and MSN. At this time, Google Ta

Page 254

Batch Organization Fields 339Syntaxfile_transfer_send=< off | internal_only | include_external >Examples• When the field is returned as output

Page 255

340 Related Fieldsfile_transfer_receiveSee Alsofooter_onThe footer_on field holds the activation status for an organization-level outbound Compliance

Page 256 - Batch Commands 259

Batch Organization Fields 341Related Commands• Output: displayorg• Input: modifyorgSee AlsoThe Message Security Administration Guide, “Configuring O

Page 257

34 domain_tls displayThe domain_tls display command displays Policy-Enforced TLS settings for organizations which need to identify domain names that

Page 258 - Batch Commands 261

342 NotesAn organization can be referenced by several different fields:• orgname -- The organization’s string name• orgtag -- The organization’s stri

Page 259

Batch Organization Fields 343im_enable 1 (on)• To change the setting:modifyorg= sales, im_enable=onDescriptionEnables IM Security:• off -- Disables

Page 260

344 im_external_enableThe im_external_enable field is an organization-level IM Security switch which enables IM users to communicate with external us

Page 261

Batch Organization Fields 345Authorization• Read: IM Management• Write: IM ManagementNotesExternal messages are any IM communication with user’s out

Page 262

346 Examples• When the field is returned as output:im_proto_enable +all, +msn, +aim, +yahoo, +google• Adding a protocol and removing another:modifyor

Page 263

Batch Organization Fields 347Related Commands• Input: user_im_settings add, user_im_settings modify• Output: displayorg, org_im_settings display,use

Page 264 - Batch Commands 267

348 NotesIf an email config organization which has blocked IP ranges for a domain is converted to a user organization, the blocked IP ranges are dele

Page 265

Batch Organization Fields 349Examplesarchive_settings modify org=Jumbo ABC, archive_enable=on, mail_flow=on, journaling=onDescriptionEnables archivi

Page 266 - Batch Commands 269

350 lang_locale (for orgs)The lang_locale field enables organization-level language localization in the Quarantine Summary’s static text, the default

Page 267

Batch Organization Fields 351Related Commands• Output: displayorg• Input: modifyorgSee Also“Viewing Message Center Settings” on page 536“Editing Qua

Page 268 - Batch Commands 271

Batch Command and Field Quick Summary 35This is applicable to the Google Message Security, Google Message Discovery, and Google Message Filtering pr

Page 269

352 Authorization• Read: Edit Organization• Write: Read-only for administratorsRelated CommandsOutput: displayorgSee AlsoThe Message Security Adminis

Page 270 - Locked Domain:IP addresses

Batch Organization Fields 353Field TypeOrg-levelAuthorization• Read: Edit organizations• Write: Edit organizationsRelated Commands• Input: archive_s

Page 271

354 modifyorg sales, max_message_size=250DescriptionMaximum size of inbound messages in megabytes, allowed for this organization.• NULL (200M) -- Thi

Page 272

Batch Organization Fields 355See Also“Viewing Message Center Settings” on page 536“Viewing Message Center Settings” on page 536The Message Security

Page 273

356 Field TypeOrg-levelAuthorization• Read: Outbound Message Encryption• Write: Outbound Message EncryptionNotesEntries apply to all users in the org

Page 274

Batch Organization Fields 357Syntaxmessage_encryption_criteria=<string> | NULLExamples• When the field is returned as output:message_encryptio

Page 275

358 See Also“Viewing and Editing Message Encryption Settings” on page 565Postini Encryption Services Administration Guide, “How Connection Security W

Page 276

Batch Organization Fields 359Field TypeOrg-levelAuthorization• Read: Outbound Server Management• Write: Outbound Server ManagementNotesSome mail ser

Page 277

360 Syntaxnon_account_bounce=<on/1 I off/0 I NULL ()>Examples• When the field is returned as output:non_account_bounce 1 (on)• To change the se

Page 278 - Batch Commands 281

Batch Organization Fields 361Notes• By activating this feature, the Message Security service will compare directory information with incoming recip

Page 279

36 getorgreportThe getorgreport command builds a traffic, virus, spam, or usage report for a selected organization.Batch Command Syntax and Example:g

Page 280

362 DescriptionEnables an inbound message for unregistered users to be filtered for viruses. There is no notification associated with this dispositio

Page 281

Batch Organization Fields 363Related Commands• Output: displayorg• Input: addorg, modifyorgRelated Fieldsdisposition_virus, non_account_bounceSee Al

Page 282

364 DescriptionThis field holds the disposition for a valid or spam NDR inbound message based on the null sender address in the envelope’s FROM field

Page 283

Batch Organization Fields 365Notes• The nullsender_disposition field’s value takes precedence over Approved/Blocked Senders, Content Manager or Atta

Page 284 - Batch Commands 287

366 Syntaxnullsender_headertag_validation=< 1 - 336 | 0 | NULL >ExamplesWhen the field is given as input:modifyorg Sales, nullsender_headertag_

Page 285

Batch Organization Fields 367Related Commands• Input: modifyorg• Output: displayorgRelated Fields• ndr (for Message Security product only), nullsend

Page 286 - Batch Commands 289

368 DescriptionA unique name used to reference an organization within the Administration Console:• Enclose the organization’s name in double quotes i

Page 287

Batch Organization Fields 369Related Commands• Output: displayorg• Input: adddomain, addorg, adduser, archive_settings display, archive_settings mod

Page 288

370 Field TypeOrg-levelAuthorization• Read: Edit Organizations• Write: Edit OrganizationsNotesThe batch interface allows apostrophes, commas, #, =, “

Page 289

Batch Organization Fields 371Examples• The field as output of a command:out_at_notify_on 0• To change the setting:modifyorg sales, out_at_notify_on=

Page 290

Batch Command and Field Quick Summary 37im displayThe im display command displays an IM record for an IM screen name. This is applicable to the Goog

Page 291 - Batch Organization Fields

372 Related Fieldsat_notify_on (Inbound), max_message_size, outbound_max_message_size, qsum_actionable, qsum_enable, qtine_redir_atq, qtine_redir_out

Page 292

Batch Organization Fields 373Field TypeOrg-levelAuthorization• Read: Outbound Applications Management• Write: Outbound Applications ManagementNotesM

Page 293

374 Examples• When returned from displayorg:outbound_virus 1 (on)• When assigned:modifyorg sales, outbound_virus=1DescriptionSwitch for outbound viru

Page 294

Batch Organization Fields 375outbound_virus_dispositionThe outbound_virus_disposition field lists the disposition (bounce or redirect) of an outboun

Page 295 - Field Type

376 Related Commands• Output: displayorg• Input: modifyorgRelated Fieldsdisposition_virus, out_at_notify_on, outbound_virusSee AlsoThe Message Securi

Page 296

Batch Organization Fields 377DescriptionA valid orgname:• Entering a new parent reassigns the current org to a new parent, moving it to a new locati

Page 297

378 See AlsoThe Message Security Administration Guide, “Organization Management”qsum_actionableThe qsum_actionable field determines if Quarantine Sum

Page 298

Batch Organization Fields 379Related Commands• Output: displayorg• Input: modifyorgRelated Fieldsat_notify_on (Inbound), max_message_size, out_at_no

Page 299

380 DescriptionSwitch for send quarantine summary notifications.• on -- Getting Quarantine Summary notifications enabled• off -- Will not get Quarant

Page 300

Batch Organization Fields 381Syntaxqtine_redir_atq=< valid user address | NULL (none) >Examples• When the field is returned as output, example

Page 301

38 iplock add_range org=<email config org name>, domain=<domain name>, range=<IP address>[/<CIDR subnet>]Single Domain and IP

Page 302

382 See AlsoThe Message Security Administration Guide, “Quarantine Summary and Notifications”qtine_redir_ndrThe qtine_redir_ndr field holds the user

Page 303

Batch Organization Fields 383Related Commands• Output: displayorg• Input: modifyorgRelated Fieldsat_notify_on (Inbound), max_message_size, out_at_no

Page 304

384 Field TypeOrg-levelAuthorization• Read: Outbound Applications Management• Write: Outbound Applications ManagementRelated Commands• Input: modifyo

Page 305

Batch Organization Fields 385Examples• When the field is returned as output:qtine_redir_out_virus [email protected]• To change the setting:modify

Page 306

386 qtine_redir_spamThe qtine_redir_spam field holds email address for the user receiving inbound spam email quarantine for an organization. When an

Page 307

Batch Organization Fields 387See Also“Viewing Message Center Settings” on page 536“Editing Quarantine Summary Notifications” on page 546The Message

Page 308

388 Related Commands• Output: displayorg• Input: modifyorgSee AlsoThe Message Security Administration Guide, “Quarantine Summary and Notifications”qu

Page 309

Batch Organization Fields 389Authorization• Read: Junk Email• Write: Junk EmailRelated Commands• Output: displayorg• Input: modifyorgRelated Fieldsq

Page 310

390 DescriptionEnable quarantine summary message link.• off -- Disables the Quarantine Summary links• on -- Enables the Quarantine Summary links• NUL

Page 311

Batch Organization Fields 391remotecmd_secretThe remotecmd_secret field holds the shared secret for digitally signing EZCommand URLs.This field is a

Page 312

Batch Command and Field Quick Summary 39This command is applicable to the Google Message Security, Google Message Discovery, and Google Message Filt

Page 313

392 Related Fieldsauthentication_dataSee AlsoThe Message Security Administration Guide, “Batch Processing and EZCommandsretention_monthsThe retention

Page 314

Batch Organization Fields 393Authorization• Read: Edit organizations-Advanced Applications-Message Archiving• Write: Read-only for administratorsRel

Page 315

394 DescriptionSends spam quarantined notifications:• on -- Spam quarantine notifications can be sent• NULL ()-- This field is not active.• off -- Sp

Page 316

Batch Organization Fields 395This field is applicable to the Google Message Security, Google Message Discovery, and Google Message Filtering product

Page 317

396 NotesAn organization’s IM conversations are journaled by being sent as email to participants and/or text of the conversation is sent directly to

Page 318

Batch Organization Fields 397Examples• When the field is returned as output:support_contact [email protected]• To change the setting:modifyorg sal

Page 319

398 See Also“Viewing Authentication and Password Settings” on page 540“Seeing if a User Has Received a Welcome Notification” on page 547The Message S

Page 320

Batch Organization Fields 399Authorization• Read: Junk Email• Write: Junk EmailRelated Commands• Output: displayorg• Input: modifyorgRelated Fieldsb

Page 321

400 Field TypeOrg-levelAuthorization• Read: Application Management, Account Settings, Regional Settings• Write: Application Management, Account Setti

Page 322

Batch Organization Fields 401modifyorg Sales tls_notify_admin = [email protected]• To enable a TLS alert:modifyorg Sales tls_notify_admin = msmith

Page 323

40 listdomains <domain name qstring | ALL> , targetOrg=<org name>[,orgtaggs=<orgtag qstring> ][, primaryqs=<primary domain qstri

Page 324

402 tls_notify_onThe tls_notify_on field enables Policy-Enforced TLS alerts for an email config organization. It also acts as a throttle for the aler

Page 325

Batch Organization Fields 403Related Commands• Input: modifyorg• Output: displayorgRelated Fieldstls_notify_adminSee AlsoPostini Encryption Services

Page 326

404 Field TypeOrg-levelAuthorization• Read: Virus• Write: VirusRelated Commands• Output: displayorg• Input: modifyorgRelated Fieldsantivirus_sensitiv

Page 327

Batch Organization Fields 405To change the setting:modifyorg JumboInc virus_notify=9DescriptionLists how frequently virus notification email will be

Page 328

406 See Also“Viewing Authentication and Password Settings” on page 540“Seeing if a User Has Received a Welcome Notification” on page 547“Setting a Vi

Page 329

Batch Organization Fields 407Authorization• Read: Edit Organizations• Write: Edit OrganizationsNotesThe adduser command’s welcome parameter enables

Page 330

408 Examples• When the field is returned as output:zero_hour_notify_on 1 (on)• To change the setting:modifyorg sales, zero_hour_notify_on=onDescripti

Page 331

Batch Organization Fields 409Related Fields“zero_hour_scan” on page 409See Alsozero_hour_scanThe zero_hour_scan field enables or disables the Early

Page 332

410 NotesThis field can be viewed before the Early Detection Quarantine waiver is signed. Once the Earlly Detection Quarantine waiver is signed in th

Page 333

Chapter 7 Batch User Fields 411Batch User FieldsChapter 7About Batch User FieldsThe batch user fields hold user-level data which a command can either

Page 334

Contents 5ContentsChapter 1: Introduction to Batch Processing ... 13About this Book...

Page 335

Batch Command and Field Quick Summary 41listprovusers <org name>[, subset=ALL | BLOCK | UNBLOCK][, addressqs=<match spec>][, childorgs=0

Page 336

412 See “Batch Command and Field Quick Summary” on page 27, and “Batch Field Quick Summary” on page 111 for additional information.activeThe active f

Page 337

Batch User Fields 413Related Commands• Input: listusers• Output: displayuser, listusersSee Also“Viewing Message Center Settings” on page 536“Seeing

Page 338

414 Authorization• Read: Change Address• Write: Change AddressNotesThe Batch interface allows apostrophes, commas, #, =, “ “, ‘ ‘ symbols in user or

Page 339

Batch User Fields 415Examples• When the field is returned as output, example as empty:approved_recipients empty• Adding a mailing list to the Approv

Page 340

416 Notes• Adding or deleting a domain applies to subdomains.• Approved Recipient lists have a size limit of 4000 characters which approximately equa

Page 341

Batch User Fields 417modifyuser [email protected], [email protected]• Adding a domain and removing a domain from the Approved Sen

Page 342

418 Notes• Mail from senders on this list will bypass the Junk Email filters.• If virus blocking is enabled for the recipient, the message will not b

Page 343

Batch User Fields 419blocked_senders (for users)The blocked_senders field lists an email address or a domain to be added or removed from the user-le

Page 344

420 Field TypeUser-levelAuthorization• Read: Senders Lists • Write: Senders ListsNotes• Adding or deleting a domain from the list applies to subdomai

Page 345

Batch User Fields 421See Also“Viewing Authentication and Password Settings” on page 540“Viewing Message Center Settings” on page 536The Message Secu

Page 346

42 Batch Command Syntax and Example:modifydomain <domain name>, [neworg=<org name> | substrip=<yes | no> | alias=<alias name| -a

Page 347

422 NotesOrganizations created during a Directory Sync synchronization are created by the addorg command, and the organizations’ create_method field

Page 348

Batch User Fields 423Authorization• Read: User Settings• Write: Read-only for administratorsNotesThis field only applies to deployments of Perimeter

Page 349

424 DescriptionThe date the im_map record was created. This date is displayed in the Administration Console in Greenwich Mean Time. For example:creat

Page 350

Batch User Fields 425ExamplesWhen assigning the field:modifyuser [email protected], filter_adult=11modifyuser [email protected], filter_adult=mo

Page 351

426 See Also“Editing Message Center Access and Settings” on page 538“Viewing Authentication and Password Settings” on page 540The Message Security Ad

Page 352

Batch User Fields 427Authorization• Read: Spam Filters• Write: Spam FiltersRelated Commands• Input: adduser, modifyuser• Output: displayuserRelated

Page 353

428 DescriptionLevel of get-rich-quick content:• 11/off (1)• 12/lenient (2)• 13/moderate (3) (medium, in Message Center II)• 14/moderately-aggressive

Page 354

Batch User Fields 429Syntaxfilter_offers=<number | text>ExamplesWhen the field is assigned:modifyuser [email protected], filter_offers=11mod

Page 355

430 Related Fieldsfilter_adult, filter_bulk, filter_getrich, filter_racial, junkmail_filterSee Also“Viewing Authentication and Password Settings” on

Page 356

Batch User Fields 431Authorization• Read: Spam Filters• Write: Spam FiltersRelated Commands• Input: adduser, modifyuser• Output: displayuserRelated

Page 357

Batch Command and Field Quick Summary 43notification modify type=attachment_manager_inbound, org=<org name> [ , <state=<user | quarantin

Page 358

432 DescriptionThe IM user’s screen name.Field TypeUser-levelAuthorization• Read: User Settings, IM Management• Write: User Settings, IM ManagementRe

Page 359

Batch User Fields 433DescriptionSystem generated temporary password for new users in orgs with PMP authentication. This password expires after 30 da

Page 360

434 junkmail_filterThe junkmail_filter field is an on/off switch for Spam Filtering.Syntaxjunkmail_filter=<off/0 | on/1>Examples• When the fiel

Page 361

Batch User Fields 435Related Fieldsfilter_adult, filter_bulk, filter_getrich, filter_offers, filter_racialSee Also“Editing Message Center Access and

Page 362

436 Field TypeUser-levelAuthorization• Read: Regional Settings• Write: Regional SettingsRelated Commands• Input: adduser, modifyuser• Output: display

Page 363

Batch User Fields 437Field TypeUser-levelAuthorization• Read: User Settings• Write: Read-only for administratorsRelated CommandsOutput: displayuserR

Page 364

438 The count goes up in increments of 8 for system performance optimization.Field TypeUser-levelAuthorization• Read: Traffic Limits• Write: Read-onl

Page 365

Batch User Fields 439modifyuser [email protected], message_encryption=onNote: See message_encryption (for an org’s outbound encrypted messages) fo

Page 366

440 See AlsoPostini Encryption Services Administration Guide, “How Connection Security Works”message_limitThe message_limit field holds the maximum n

Page 367

Batch User Fields 441Notes• This limit can also be set for individual users or for the organization as a whole. Whichever limit is lower—the org lim

Page 368

44 notification modify type=welcome_user, org=<org name> [ , state=<on | off> ] | [ , text=link:<the org name which shares the notific

Page 369

442 message_limited 0 (no)DescriptionShows the user has reached the message limit.• no -- Message limit has not been reached• yes -- Message limit ha

Page 370

Batch User Fields 443Examples• When the field is returned as output:notice_address [email protected]• Adding a new user:adduser [email protected],

Page 371

444 See Also“Editing Message Center Access and Settings” on page 538The Message Security Administration Guide, “Users and Quarantines”orgidThe orgid

Page 372

Batch User Fields 445Authorization• Read: User Settings• Write: User SettingsNotes• The Batch interface allows apostrophes, commas, #, =, “ “, ‘ ‘ s

Page 373

446 Syntaxpassword=<printable characters>Examples• When the field is returned as output (encrypted):password 3pds9999• To change the setting (w

Page 374

Batch User Fields 447Authorization• Read: Change Passwords• Write: Change PasswordsRelated Commands• Input: adduser, modifyuser, password reset• Out

Page 375

448 Field TypeUser-levelAuthorization• Read: User Settings• Write: Read-only for administratorsRelated CommandsOutput: listusersSee AlsoThe Message S

Page 376

Batch User Fields 449Authorization• Read: User Settings• Write: Read-only for administratorsNotesThe Batch interface allows apostrophes, commas, #,

Page 377

450 DescriptionUNIX TZ timezone for Message Center, and for Message Center Classic user wireless email settings which applies only if Wireless Forwar

Page 378

Batch User Fields 451TS1The TS1 field holds the most recent timestamp for a good email message to a provisional user.This field is applicable to the

Page 379

Batch Command and Field Quick Summary 45password force_update user=<user address>password force_update org=<org name> [, cascade= <ye

Page 380 - Archive Retention Months: 3

452 Related Commands• Input: listprovusers• Output: displayprovuser• Related: blockprovuser, deleteprovuser, promoteprovuser, unblockprovuserRelated

Page 381

Batch User Fields 453Authorization• Read: Add Users• Write: Read-only for administratorsNotesUsed with SmartCreate, newly added users are unconfirme

Page 382

454 DescriptionThe user’s unique ID.Field TypeUser-levelAuthorization• Read: User Settings• Write: Read-only for administratorsRelated CommandsOutput

Page 383

Batch User Fields 455DescriptionUnique user ID. This is the same as the uid and user_id fields.Field TypeUser-levelAuthorization• Read: User Setting

Page 384

456 user_id 2001122283DescriptionUnique key for each user. A user’s primary email address can be changed, but its ID always remains the same. This is

Page 385

Batch User Fields 457Examples• When the field is returned as output:virus_notify NULL ()• To change the setting:modifyuser [email protected], viru

Page 386

458 virus_stateThe virus_state field is an on/off/unavailable switch for virus scanning functionality.Syntaxvirus_state=< 0/on | 1/off | 2/unavail

Page 387 - Tijuana)

Batch User Fields 459See AlsoThe Message Security Administration Guide, “Virus Filters”weblockedThe weblocked field is an on/off switch giving Messa

Page 388

460 Related Commands• Input: adduser, modifyuser• Output: displayuserSee Also“Editing Message Center Access and Settings” on page 538The Message Secu

Page 389

Batch User Fields 461Related CommandsOutput: displayuserSee Also“Viewing Authentication and Password Settings” on page 540“Seeing if a User Has Rece

Page 390

46 password_policy update <org=<org name>> | <iid=<org ID>>[, min_length=<1 - 10> | null ] [, required_complexity=<n

Page 391

462 Field TypeUser-levelAuthorizationWrite: Wireless SettingsNotes• Available only to North American users and applies only to Message Center Classic

Page 392

Chapter 8 Batch Domain Fields 463Batch Domain FieldsChapter 8About Batch Domain FieldsThe batch domain fields hold domain-level data which a command

Page 393

464 aliasThe alias field holds the domain’s aliases.Syntaxalias = <alias>, ...Examplesmodifydomain jumboinc.com, alias=jumboalias.comDescriptio

Page 394

Batch Domain Fields 465aliasedfromThe aliasedfrom field lists a domain’s aliases.Syntaxaliasedfrom < domain’s alias >, ...Examplesaliasedfrom

Page 395

466 Syntaxaliasedto <primary domain name>Examplesaliasedto jumboinc.comDescriptionLists the domain associated with this alias.Field TypeDomainA

Page 396

Batch Domain Fields 467Syntaxcatchall = <user address | NONE>Examplescatchall [email protected] account assigned as the

Page 397

468 Related CommandsInput: modifydomainRelated Fieldsnon_account_virus_scanSee AlsoThe Message Security Administration Guide, “Domains”created_ts (fo

Page 398

Batch Domain Fields 469Related Commands• Input: listdomains• Output: listdomainsRelated Fieldscreated_ts (for users)See AlsoThe Message Security Adm

Page 399 - Batch User Fields

470 Related Commands• Input: deletedomain, displaydomain, listdomains• Output: listdomainsRelated Fieldsdomainname, primary_didSee AlsoThe Message Se

Page 400

Batch Domain Fields 471Authorization• Read: Edit Organizations, Manage Domains• Write: Edit Organizations, Manage DomainsRelated Commands• Input: ad

Page 401 - Batch User Fields 413

Batch Command and Field Quick Summary 47Batch Command Syntax and Example:setorgsubstripping <org name | iid>,<on/1 | off/0>setorgsubstri

Page 402

472 DescriptionThe organization associated with this domain.Field TypeDomainAuthorization• Read: Edit Organizations, Manage Domains• Write: Read-only

Page 403

Batch Domain Fields 473Field TypeDomainAuthorization• Read: Edit Organizations, Manage Domains• Write: Read-only for administratorsRelated CommandsO

Page 404

474 Authorization• Read: Edit Organizations, Manage Domains• Write: Read-only for administratorsRelated CommandsOutput: listdomainsSee AlsoThe Messag

Page 405

Batch Domain Fields 475Field TypeDomainAuthorization• Read: Edit Organizations, Manage Domains• Write: Edit Organizations, Manage DomainsRelated Com

Page 406

476 DescriptionEnables subdomain substripping for a domain. The sub domains become aliases for the primary domain.• on -- Domain substripping is enab

Page 407

Chapter 9 Batch Report Fields 477Batch Report FieldsChapter 9About Batch Report FieldsThe batch report fields hold the return data displayed by the g

Page 408

478 acc_messagesThe acc_messages field holds the number of email messages sent to accounts or aliases registered in the Message Security service for

Page 409 - Batch User Fields 421

Batch Report Fields 479Related Fieldsnum_bh_messages, num_bytes, num_f_messages, num_messages, num_q_messages, pct_bh_bytes, pct_bh_messages, pct_f_

Page 410

480 Related CommandsOutput: getorgreport (Org Virus and Spam Summary Reports)Related Fields• spam: bad_isp, bad_sender, bulk, bytes, commerce, delive

Page 411 - Batch User Fields 423

Batch Report Fields 481Authorization• Read: View Reports• Write: Read-only for administratorsNote: Review the getorgreport command authorizations be

Page 412

48 Batch Command Syntax and Example:testmx <domain name>testmx mailserver.jumboinc.comunblockprovuserThe unblockprovuser command unblocks provi

Page 413 - Batch User Fields 425

482 NotesMail messages that do not match a domain’s IP block and have a quarantine disposition, are included in the bad_sender field’s total.Field Ty

Page 414

Batch Report Fields 483ExamplesWhen the field is returned as output:bulk 3DescriptionGeneral category for junk email filtering (may include characte

Page 415 - Batch User Fields 427

484 Syntaxbytes= <total number string>ExamplesWhen the field is returned as output:bytes 3DescriptionSpam and Virus Bytes. Total size of quaran

Page 416

Batch Report Fields 485cleaningsThe cleanings field holds the number of viruses cleaned for the Virus Report.Syntaxcleanings= <total number strin

Page 417 - Batch User Fields 429

486 See AlsoThe Message Security Administration Guide, “Reports”clean_failuresThe clean_failures field holds the number of viruses cleaning failures

Page 418

Batch Report Fields 487Related Fieldsaccount, bytes, cleanings, inf_deliveries, num_virusesSee AlsoThe Message Security Administration Guide, “Repor

Page 419 - Batch User Fields 431

488 Related CommandsOutput: getorgreport (Org Spam Summary Report)Related Fieldsaccount, bad_isp, bad_sender, bulk, bytes, deliveries, mmf, naughty,

Page 420

Batch Report Fields 489Authorization• Read: Account-level permissions• Write: Read-only for administratorsNote: Review the getorgreport command auth

Page 421 - Batch User Fields 433

490 Field TypeOrg Report ManagementAuthorization• Read: Account-level permissions• Write: Read-only for administratorsReview the getorgreport command

Page 422

Batch Report Fields 491DescriptionTotal number of spam messages delivered from Quarantine to the user’s mailbox.Field TypeOrg Spam ReportAuthorizati

Page 423

Batch Command and Field Quick Summary 49user_im_settings displayThe user_im_settings display command displays IM settings for a given user email add

Page 424

492 ExamplesWhen the field is returned as output:inf_deliveries 3DescriptionTotal number of infected deliveries from quarantine spam messages.Field T

Page 425 - Batch User Fields 437

Batch Report Fields 493Syntaxmessages=<number of messages in report>ExamplesWhen the field is returned as output:messages 11DescriptionNumber

Page 426

494 mmfThe mmf field holds the total number of Get Rich messages for the Spam Report.Syntaxmmf= <total number string>ExamplesWhen the field is

Page 427 - Batch User Fields 439

Batch Report Fields 495See AlsoThe Message Security Administration Guide, “Reports”naughtyThe naughty field holds the total number of messages trigg

Page 428

496 Related Fieldsaccount, bad_isp, bad_sender, bulk, bytes, commerce, deliveries, mmf, num_spams, racial, ssbSee AlsoThe Message Security Administra

Page 429 - 554 Mailbox

Batch Report Fields 497Review the getorgreport command authorizations before running the Traffic Report summary.Related CommandsOutput: getorgreport

Page 430

498 Field TypeOrg Traffic ReportAuthorizationRead: View ReportsWrite: Read-only for administratorsRelated CommandsOutput: getorgreport (Org Traffic S

Page 431 - Batch User Fields 443

Batch Report Fields 499DescriptionTotal number of messages delivered directly to your mail server for all addresses in the server’s domain.Field Typ

Page 432

500 ExamplesWhen the field is returned as output:num_messages 3For a traffic summary report in the Administration Console, num_messages is the same a

Page 433

Batch Report Fields 501Syntaxnum_q_messages= <total number string>ExamplesWhen the field is returned as output:num_q_messages 3For a traffic s

Page 434

50 alias = <alias>, ...modifydomain jumboinc.com, alias=jumboalias.comaliasedfromThe aliasedfrom field lists a domain’s aliases.Syntax and Exam

Page 435 - Batch User Fields 447

502 num_spamsThe num_spams field holds the number of quarantined spam for the Spam Report.Syntaxnum_spams= <total number string>ExamplesWhen th

Page 436

Batch Report Fields 503See AlsoThe Message Security Administration Guide, “Reports”num_virusesThe num_viruses field holds the total number of quaran

Page 437 - Batch User Fields 449

504 See AlsoThe Message Security Administration Guide, “Reports”pct_bh_bytesThe pct_bh_bytes field holds the total percent of blackholed messages in

Page 438

Batch Report Fields 505Related Fieldsacc_messages, num_bh_messages, num_bytes, num_f_messages, num_messages, num_q_messages, pct_bh_messages, pct_f_

Page 439 - TS1 1145962000

506 Related CommandsOutput: getorgreport (Org Traffic Summary Report)Related Fieldsacc_messages, num_bh_messages, num_bytes, num_f_messages, num_mess

Page 440

Batch Report Fields 507Authorization• Read: View Reports• Write: Read-only for administratorsRelated CommandsOutput: getorgreport (Org Traffic Summa

Page 441 - Batch User Fields 453

508 Field TypeOrg Traffic ReportAuthorization• Read: View Reports• Write: Read-only for administratorsRelated CommandsOutput: getorgreport (Org Traff

Page 442

Batch Report Fields 509DescriptionTotal number of percent of quarantined messages in bytes.Field TypeOrg Traffic ReportAuthorization• Read: View Rep

Page 443 - Batch User Fields 455

510 pct_q_messages 3.0For a traffic summary report in the Administration Console, pct_q_messages is the same as Quarantined Acct Msgs, % of Msgs.Desc

Page 444

Batch Report Fields 511Syntaxproductid=<name of product>ExamplesAs part of the settings output of the getorgreport command:productid eeDescrip

Page 445 - Batch User Fields 457

6 Release 6.19 IP Locking Commands...100List Commands...

Page 446

Batch Command and Field Quick Summary 51domainname=<string>domainname jumboinc.comorg (for domains)The org (for domains) field holds the organ

Page 447 - Batch User Fields 459

512 Syntaxracial= <total number string>ExamplesWhen the field is returned as output:racial 3DescriptionTotal number of messages triggering the

Page 448

Batch Report Fields 513recipThe recip field holds the email address of the recipient account for the Traffic Report.Syntaxrecip= <email address&g

Page 449

514 See AlsoThe Message Security Administration Guide, “Reports”selleridThe sellerid field holds the unique identifying number of the Message Securit

Page 450

Batch Report Fields 515Related Fieldscustomerid, customername, messages, productid, stored_size, usersSee AlsoThe Message Security Administration Gu

Page 451 - Batch Domain Fields

516 Related Fieldsaccount, bad_isp, bad_sender, bulk, bytes, commerce, deliveries, mmf, naughty, num_spams, racialSee AlsoThe Message Security Admini

Page 452

Batch Report Fields 517Related CommandsOutput: getorgreportRelated Fieldscustomerid, customername, messages, productid, sellerid, usersSee AlsoThe M

Page 453 - Batch Domain Fields 465

518 usersThe users field holds the total number of users in the Usage Report.Syntaxusers=<number of users>ExamplesAs part of the settings outpu

Page 454

Batch Report Fields 519

Page 455 - Batch Domain Fields 467

Chapter 10 Batch Spool Fields 521Batch Spool FieldsChapter 10About Batch Spool FieldsThe batch spool fields hold the return data displayed by the dis

Page 456

522 auto_unspoolThe auto_unspool field is the on/off switch for automatically delivering spooled messages.Syntaxauto_unspool=<off/0 | on/1>Exam

Page 457 - Batch Domain Fields 469

52 sub_strip=< on/1 | off/0 >sub_strip=onsubstripThe substrip field enables subdomain substripping for the domain.This is applicable to the Goo

Page 458

Batch Spool Fields 523Related Fieldsdespool_max_connections, duration, org (for spooling), quota, spool_delay, spool_mech, status, used_pct, used_si

Page 459 - Batch Domain Fields 471

524 Notes• This rate should deliver messages at a volume that your mail servers can safely manage. We recommend allocating no more than 15% of the su

Page 460

Batch Spool Fields 525Field TypeOrg Spool managementAuthorization• Read: Spooling• Write: Read-only for administratorsRelated CommandsOutput: displa

Page 461 - Batch Domain Fields 473

526 DescriptionName of the email config organization associated with spooling.Field TypeOrg Spool managementAuthorization• Read: Spooling• Write: Rea

Page 462

Batch Spool Fields 527Syntaxquota=<assigned space in bytes>ExamplesAs part of the settings output of the displayspool command:quota 5242880Des

Page 463 - Batch Domain Fields 475

528 See AlsoThe Message Security Administration Guide, “Spool Manager”spool_delayThe spool_delay field, in conjunction with connection failures, dete

Page 464

Batch Spool Fields 529Related CommandsOutput: displayspoolRelated Fieldsauto_unspool, despool_max_connections, duration, org (for spooling), quota,

Page 465 - Batch Report Fields

530 DescriptionSpool initiation states:• Automatic -- The Spool Manager starts spooling automatically when there is an outage. Spool Manager must be

Page 466

Batch Spool Fields 531See AlsoThe Message Security Administration Guide, “Spool Manager”statusThe status field holds email config organization’s sta

Page 467 - Batch Report Fields 479

532 Authorization• Read: Spooling• Write: Read-only for administratorsRelated CommandsOutput: displayspoolRelated Fieldsauto_unspool, despool_max_con

Page 468

Batch Command and Field Quick Summary 53archive_enable=<on | off | NULL>archive_settings modify org=Jumbo ABC, archive_enable=on, mail_flow=on

Page 469 - Batch Report Fields 481

Batch Spool Fields 533Field TypeOrg Spool managementAuthorization• Read: Spooling• Write: Read-only for administratorsNotesThe used_pct field is the

Page 470

534 used_size 0DescriptionShows the total of used allocated spool storage in bytes.Spool Manager does not issue alerts for manually initiated spoolin

Page 471 - Batch Report Fields 483

Chapter 11 Examples of Common Tasks 535Examples of Common TasksChapter 11About Common Task ExamplesThis chapter presents examples of common organizat

Page 472

536 #is_email_config yesEach task code sample is documented explaining these inter-relationships and has links to a reference pages for additional ex

Page 473 - Batch Report Fields 485

Examples of Common Tasks 537The approved_recipients field holds an email address or domain to be added or removed from the Approved Recipients list

Page 474

538 The timezone field is shown in the Quarantine Summary and the Message Center.WARNING: Don’t change this setting in the Administration Console. It

Page 475 - Batch Report Fields 487

Examples of Common Tasks 539The weblocked field is an on/off switch giving Message Center Access for the any user including the Default User. The ‘0

Page 476

540 The junkmail_filter field is an on/off switch for Spam FilteringThe filter_adult field holds the sexual content filter settings for the user.The

Page 477 - Batch Report Fields 489

Examples of Common Tasks 541Since POP authentication is a non-PMP authentication type, find the authentication_data field which holds the text strin

Page 478

542 The displayuser command’s output lists the password field:password 5d000003. Use the modifyuser command to change the user’s PMP password.modifyu

Page 479 - Batch Report Fields 491

54 modifyorg sales, authentication_data=”mypopserver, +jumboinc.com”modifyorg sales, authentication_data=”mypopserver, @USERDOMAIN”modifyorg sales, a

Page 480

Examples of Common Tasks 543Note: The user-level welcome_count field shows whether a welcome message has been sent to a specific user. Use the displ

Page 481 - Batch Report Fields 493

544 The company_name field holds the company or entity name that is used in email notifications.The support_contact field holds the address of the su

Page 482

Examples of Common Tasks 545displayorg SalesThe quarantine_links field is a switch to enable quarantine message links to be available in the Message

Page 483 - Batch Report Fields 495

546 The qtine_redir_spam field holds email address for the user receiving inbound spam email quarantine for an organization. When an outbound message

Page 484

Examples of Common Tasks 547The qsum_actionable field holds the action available in Quarantine Summary notifications.The qsum_enable field is a swit

Page 485 - Batch Report Fields 497

548 Find the Welcome Notification Setting1. Using the displayuser command, determine if a user qualifies for a welcome notification. The user must no

Page 486

Examples of Common Tasks 5492. Using the displayorg command, determine if the My First Spam notification has been sent.displayorg SalesThe disable_f

Page 487 - Batch Report Fields 499

550 The virus_notify (for orgs) field holds frequency of a user’s virus notifications.The possible values:0=immediately1=nomore than one notice per d

Page 488

Examples of Common Tasks 551The listorgs command returns a list of your Account, Email Config, and User organizations showing each org’s unique ID n

Page 489 - Batch Report Fields 501

552 listdomains ALL, aliases=0, childorgs=1With the parameter aliases=0, the list will be domains only and no domain aliases.3. If your do not have p

Page 490

Batch Command and Field Quick Summary 55Syntax and Example:blocked_senders=< [+] | -emailaddress> | < [+] | -domain name | empty>,...mod

Page 491 - Batch Report Fields 503

Examples of Common Tasks 553To locate a Default User either use the default_user field with the displayorg command or see if the listusers command’s

Page 492

554 2. Using the displayuser command, display the Default User settings.displayuser [email protected]. Using the resetuser command, reset a susp

Page 493 - Batch Report Fields 505

Examples of Common Tasks 555In the displayorg command’s output, find the blocked_senders (for orgs) field which holds lists an email address or a do

Page 494

556 modifyorg sales, approved_senders= [email protected]. Using the modifyuser command, remove one user from the user-level Approved Senders list.mod

Page 495 - Batch Report Fields 507

Examples of Common Tasks 557Remove All Users from a Senders List Except for One User1. Using the modifyorg command, replace the org-level Approved S

Page 496

558 Viewing Message Limit PoliciesMessage limit policies are for the maximum size of attachments, the maximum number of messages per day, and for the

Page 497 - Batch Report Fields 509

Examples of Common Tasks 559The user-level message_limit field holds the maximum number of messages allowed per day for a specific user.message_limi

Page 498

560 The default_message_limit field holds the maximum number of messages each registered user or alias in an organization can receive per day.Leave t

Page 499 - Batch Report Fields 511

Examples of Common Tasks 561To view this organizational hierarchy follow the steps outlined in the task example, “Message Center Settings and Passwo

Page 500

562 The async_bounce field enables the Connection Manager’s control for inbound traffic. This control is for email servers, such as Microsoft Exchang

Page 501 - Batch Report Fields 513

56 createorThe creator field lists the ID of the administrator who created the organization.Syntax and Example:creator=<user address | NULL (none)

Page 502

Examples of Common Tasks 563listprovusers Sales, subset BLOCKED, childorgs=1, sort=TS1:dThe listprovusers command to list all or list a filtered lis

Page 503 - Batch Report Fields 515

564 Static text in the Quarantine Summary, along with the default top text, will display in the chosen language. See “Language and Timezone” on page

Page 504

Examples of Common Tasks 5653. Using the archive_settings modify command, change the archive settings for an organization.archive_settings modify or

Page 505

566 IM Security ExampleThis example is applicable to the Google Message Security, Google Message Discovery, and Google Message Filtering products onl

Page 506

Examples of Common Tasks 567listusers ALL, [email protected], targetOrg=100046262, childorgs=1, aliases=1The return values are a comma sepa

Page 507 - Batch Report Fields 519

Appendix A Additional Reference Information 569Additional Reference InformationAppendix ALanguage and Timezone The language for quarantine summary me

Page 508 - Batch Spool Fields

570 The Region and Language Setting also determines your date format. For all other languages not listed above, the default format is <year-month-

Page 509

Index 571IndexAAttachment Manager Fieldsat_notify_on 312bounce_fragments 323qtine_redir_out_atq 383Bbatch processing 15command syntax 18procedure 16

Page 510 - Batch Spool Fields 523

572 modifyorg 246, 563modifyuser 249, 538, 541, 550notification display 252notification modify 256org_im_settings display 261, 566org_im_settings mod

Page 511

Index 573im_proto_enable 345IM Security TasksViewing and Editing an Org’s IM Settings 566IP Range Commandsiplock add_delete 216iplock add_range 212i

Page 512 - Batch Spool Fields 525

Batch Command and Field Quick Summary 57disable_first_spamThe disable_first_spam field is an organization-level activation switch for a new user’s n

Page 513

574 qtine_redir_ndr 382qtine_redir_out_atq 383qtine_redir_spam 386qtine_redir_virus 387quarantine_links 388, 564quarsum_links 389, 564remotecmd_secre

Page 514 - Batch Spool Fields 527

Index 575SSmartCreate, See Provisional User CommandsSpool Commanddisplayspool 175Spool Field Reference page syntax notations 521Spool Field Syntax Q

Page 515

58 footer_onThe footer_on field holds the activation status for an organization-level outbound Compliance Footer which describes an email policy or l

Page 516

Batch Command and Field Quick Summary 59im_proto_enableThe im_proto_enable field lists what IM protocols are allowed for the organization.This is ap

Page 517

60 lastmod_date (for orgs)The lastmod_date (for orgs) field holds the date the organization was last modified.Syntax and Example:lastmod_date=<tim

Page 518

Contents 7archive_settings display... 148archive_settings modify .

Page 519

Batch Command and Field Quick Summary 61This is applicable to the Google Message Security, Google Message Discovery, and Google Message Filtering pr

Page 520 - Batch Spool Fields 533

62 Syntax and Example:nullsender_disposition=<quarantine | blackhole | <errstr> | ERROR <errstr> | NULL >addorg Sales, parent=”Jumb

Page 521

Batch Command and Field Quick Summary 63Syntax and Example:out_at_notify_on=< 0 | 1 | 2 | 3 | NULL ()>modifyorg sales, out_at_notify_on=1outbo

Page 522 - Examples of Common Tasks

64 qsum_actionableThe qsum_actionable field determines if Quarantine Summary links are available.Syntax and Example:qsum_actionable=<“not actionab

Page 523

Batch Command and Field Quick Summary 65qtine_redir_out_atqThe qtine_redir_out_atq field holds the user address for the Attachment Manager quarantin

Page 524

66 quarantine_linksThe quarantine_links field is a switch to enable quarantine message links to be available in the Message Center.Syntax and Example

Page 525

Batch Command and Field Quick Summary 67spam_notify_onThe spam_notify_on field is a switch enabling the sending of spam quarantine notifications.Syn

Page 526

68 tls_notify_adminThe tls_notify_admin field lists the administrator who receives the email config organization’s Policy-Enforced TLS alerts.This is

Page 527

Batch Command and Field Quick Summary 69virus_notify (for orgs)The virus_notify (for orgs) field specifies how frequently virus notification email w

Page 528 - Editing a PMP Password

70 modifyorg sales, zero_hour_scan=1Report Fieldsacc_messagesThe acc_messages field holds the number of email messages sent to accounts or aliases re

Page 529 - Notification Examples

8 Release 6.19 password force_update ...265password reset ...

Page 530

Batch Command and Field Quick Summary 71bulkThe bulk field holds the total number of messages quarantined by the general category for junk email fil

Page 531

72 commerce= <total number string>commerce 3customeridThe customerid field holds unique identifying number for an Message Security service acc

Page 532

Batch Command and Field Quick Summary 73messagesThe messages field holds the total number of messages for the Usage Report.Syntax and Example:messag

Page 533

74 num_f_messagesThe num_f_messages field holds the total number of messages delivered directly to your mail server for all addresses in the server’s

Page 534

Batch Command and Field Quick Summary 75Syntax and Example:num_viruses = <total number string>num_viruses 3pct_bh_bytesThe pct_bh_bytes field

Page 535

76 pct_q_bytesThe pct_q_bytes field holds the total percent of quarantined messages in bytes for the Traffic Report.Syntax and Example:pct_q_bytes= &

Page 536

Batch Command and Field Quick Summary 77recip= <email address>recip [email protected] sellerid field holds the unique identifying

Page 537 - Org Settings Examples

78 Spool FieldsThese fields are applicable to the Google Message Security, Google Message Discovery, and Google Message Filtering products only.auto_

Page 538

Batch Command and Field Quick Summary 79quotaThe quota field holds the assigned space available for spooling for this email config managed by Spool

Page 539

80 used_pct= < total number string>status Suspendedused_sizeThe used_size field holds the used amount of allocated spool storage for an email c

Page 540 - Resetting Users

Contents 9is_email_config ...347journaling ...

Page 541

Batch Command and Field Quick Summary 81approved_recipients=< [+] | -user address>< [+] | -domain name>,... | ‘empty’modifyuser msmith@j

Page 542 - Approved Senders list

82 created_ts (for users)The created_ts (for users) field holds the date the im_map record was created.This is applicable to the Google Message Secur

Page 543

Batch Command and Field Quick Summary 83filter_offers=<number | text>modifyuser [email protected], filter_offers=moderatefilter_racialThe fi

Page 544

84 lang_locale (for users)The lang_locale (for users) field enables user-level language localization in Message Center II’s static text, the default

Page 545

Batch Command and Field Quick Summary 85message_limitThe message_limit field holds the maximum number of messages allowed per day for this user.Synt

Page 546

86 password=<printable characters>modifyuser [email protected], password=3pds9999primaryThe primary field holds the primary user’s unique ide

Page 547

Batch Command and Field Quick Summary 87TS3The TS3 field holds the timestamp for the oldest email message to a provisional user.This is applicable t

Page 548

88 virus_notify=<0 | 1 | 9 | NULL ()>modifyuser [email protected], virus_notify=1virus_stateThe virus_state field is an on/off/unavailable sw

Page 549

Batch Command and Field Quick Summary 89

Page 550 - Quarantine Summary Example

Chapter 3 Batch Command Quick Summary 91Batch Command Quick SummaryChapter 3About the Batch Command Quick SummaryThis index is a quick summary mappin

Page 551 - Message Archiving Example

10 Release 6.19 active ...412address ..

Page 552 - Message Encryption Example

92 Add CommandsDomainsadddomain -- The adddomain command adds a domain to your organization hierarchy. This is applicable to the Google Message Secur

Page 553 - User Settings Examples

Batch Command Quick Summary 93Policy Enforced TLS, Message Encryptiondomain_tls add -- The domain_tls add command adds Policy-Enforced TLS enablemen

Page 554

94 IP Lockingiplock delete -- The iplock delete command removes all domains with IP limitations configured in the specified email configuration organ

Page 555 - Language and Timezone

Batch Command Quick Summary 95Display and Report CommandsDomainsdisplaydomain -- The displaydomain command displays all of the selected domain’s set

Page 556

96 Organizationsdisplayorg -- The displayorg command displays all the selected organization’s settings informationPMP Passwordspassword_policy displa

Page 557 - Index 571

Batch Command Quick Summary 97Usersdisplayuser -- The displayuser command shows all the user’s settings information.Domain Management CommandsAdd Do

Page 558

98 Policy Enforced TLS, Message Encryptiondomain_tls add -- The domain_tls add command adds Policy-Enforced TLS enablement to organizations which nee

Page 559 - Index 573

Batch Command Quick Summary 99Deleteim delete -- The im delete command deletes the IM record associated with the user’s IM screen name. This is appl

Page 560

100 IP Locking CommandsAddiplock add_range -- The iplock add_range command allows emails from specific domains with specific IP addresses to be deliv

Page 561 - Index 575

Batch Command Quick Summary 101IM Securityim list -- The im list command displays IM screen names for a specific organization. This is applicable to

Comments to this Manuals

No comments